Click above to get retro games delivered to your door ever month!

 FSDirAdd()
------------------------------------------------------------------------------
 Purpose:
 Add a directory to the file server.

 Syntax:
 bResult = FSDirAdd( lpszFileSpec, iRights )

 Parameters:
 lpszFileSpec The full NetWare path of the directory to create.
 iRights      The maximum rights mask of the new directory.

 Returns:
 A boolean value (TRUE or FALSE).

 The CA-Clipper name for this function is:
 FSDirAdd()

 Description:
 FSDirAdd() creates a new network directory with the path specified by
 lpszFileSpec. This must be the full NetWare path including the volume
 name, e.g. SYS:PUBLIC\NEWDIR. iRights is the maximum rights mask of the
 new directory, i.e. the maximum level of access users can gain to the
 directory. This would normally be set to 255, the maximum allowed rights.
 The effective rights of the workstation will be the lesser of the maximum
 rights mask and the access rights of the current user. The rights value is
 calculated by adding values from the following table:

 Value  NetWare 286  NetWare 386 & NetWare 4.0
 1      Read         Read
 2      Write        Write
 4      Open         Reserved
 8      Create       Create
 16     Delete       Erase
 32     Parental     Access Control
 64     Search       File Scan
 128    Modify       Modify
 256    N/A          Supervisor

 For example, if a directory is to have Read, Open and Search rights as its
 maximum inherited rights, the value will be 69 (ie. 1 + 4 + 64).
 Returns FALSE if an error occurs.

 Example:
 // To create a new directory called NEWDIR with maximum rights
 // in the SYS:SYSTEM directory:
 if ( FSDirAdd( "SYS:SYSTEM\NEWDIR", 255 ) )
    ? "Directory NEWDIR created successfully"
 endif

 Notes:
 This function can only be used to create network directories
 because access masks are not supported on local drives.

 Appropriate trustee access rights are required to use this function.