0.9b (c) 1995 Peter Childs
The function modifies a home directory definition.
Syntax
MyRc = NetSetInfo(NETHOMEDIR, dcName, userId, homeDir)
Parameters
The parameters required are:
dcName The computer name of the domain controller
userId The name of the userid
homeDir The home directory specification. It must respect one of the following rules:
1. homeDir is set to a none value, the home directory is removed
2. a drive assignment is required, the homeDir value must include:
x:\machineID\Y$\pathname ! ! ! ! ! ! ! The path to the home directory ! ! The drive on the server holding the home directory ! The computer name of the server The drive to be assigned
For example, the userid home directory has to be located on the server FILESRV on drive D and directory \FILES\USERID. The userid will have the home directory assigned as the Y drive. This requires the following definition of the home directory:
Y:\FILESRV\D$\FILES\USERID
3. a drive assignment is not required, the homeDir value must include:
\\machineID\Y$\pathname ! ! ! ! ! The path to the home directory ! The drive on the server holding the home directory The computer name of the server
For example, the userid home directory has to be located on the server THESRV on drive F and directory \FILES\USERS\SHARED. The userid will have the home directory assigned as the first free drive. This requires the following definition of the home directory:
\\THESRV\F$\FILES\USERS\SHARED
Note
The dcName can be specified as '' for a local domain controller.
The administrator is responsible for the following:
1. Making sure the home directory exist
2. Creating required access to the directory
3. Removing a home directory if required
Example
/* Set a home director for a userid */ call RxFuncAdd 'LoadLsRxutFuncs', 'LSRXUT', 'LoadLsRxutFuncs' call LoadLsRxutFuncs NETHOMEDIR = 230 dcName = '\\ILIDC' userId = 'WS222B' homeDir = 'Y:\ILIDC\D$\SHARED\FILES' /* Remove home directory parameter */ /* homeDir = '' */ MyRc = NetSetInfo(NETHOMEDIR, dcName, userId, homeDir) if myRc <> '0' then do say 'Got error from NetSetInfo() ' myRc call DropLsRxutFuncs call RxFuncDrop 'LoadLsRxutFuncs' exit 9 end else do say say "Home directory definition modified successfully" end call DropLsRxutFuncs call RxFuncDrop 'LoadLsRxutFuncs' exit 0
Example Output
Home directory definition modified successfully
Inf-HTML End Run - Successful