NWScanDirectoryForTrustees2(3nw)


NWScanDirectoryForTrustees2 -- scans directory for trustees using path and directory handle

Synopsis

   #include <nwdirect.h> 
   or 
   #include <nwcalls.h> 
   

NWCCODE N_API NWScanDirectoryForTrustees2 (NWCONN_HANDLE conn, NWDIR_HANDLE dirHandle, pnstr8 srchPath, pnuint32 iterHandle, pnstr8 dirName, pnuint32 dirDateTime, pnuint32 ownerID, TRUSTEE_INFO N_FAR * trusteeList);

Description

The parameters are as follows:

conn
(IN) Specifies the NetWare server connection handle.

dirHandle
(IN) Specifies the NetWare directory handle for the directory being scanned.

srchPath
(IN) Points to an absolute directory path (or a path relative to the directory handle) and a search pattern.

iterHandle
(IN/OUT) Points to the sequence number to be used for subsequent calls. Should initially be set to 0.

dirName
(OUT) Points to the directory name found (optional, up to 256 bytes).

dirDateTime
(OUT) Points to the directory's creation date and time (optional).

ownerID
(OUT) Points to the bindery object ID of the directory's owner (optional).

trusteeList
(OUT) Points to an array of 20 TRUSTEE_INFO structures.

Return values

0x0000
SUCCESSFUL

0x8801
INVALID_CONNECTION

0x898C
N0_MODIFY_PRIVILEGES

0x8996
SERVER_OUT_OF_MEMORY

0x8998
VOLUME_DOES_NOT_EXIST

0x899B
BAD_DIRECTORY_HANDLE

0x899C
NO_MORE_TRUSTEES

Notices

srchPath scans include wildcard characters. If srchPath points to the complete path, including the volume name, dirHandle can be zero.

Directories can have any number of Bindery objects as trustees. These directory trustees are stored and retrieved in groups on the server. To obtain a complete list, use iterHandle, which should point to a zero value for the initial call.

NWScanDirectoryForTrustees2 increments the value referenced by iterHandle to the next appropriate value. For subsequent calls, pass in the new value of iterHandle.

Trustees are returned in groups of 20 TRUSTEE_INFO structures. Due to subtle differences in the operation of 2.x and 3.x servers, trustees may remain after an iteration, even though not all 20 positions are filled. If a position is not filled, ownerID points to a value of 0L.

NWScanDirectoryForTrustees2 should be called until it returns 0x899C (NO_MORE_TRUSTEES). Because 0x899C also means INVALID_PATH, ensure the dirHandle/pbstrSrchPath combination is correct.

NULL can be substituted for all optional items; however, all parameter positions must be filled.

Services

File Systems

NCP calls

0x2222 22 1 Get Directory Path
0x2222 22 2 Scan Directory Information
0x2222 22 12 Scan Directory For Trustees
0x2222 22 38 Trustees Scan Ext
0x2222 23 17 Get File Server Information
0x2222 87 02 Initialize Search
0x2222 87 03 Search For File or Subdirectory
0x2222 87 05 Scan File Or Subdirectory For Trustees
0x2222 87 06 Obtain File or Subdirectory Information

 
 0x2222   22   1    Get Directory 
                    Path 
 0x2222   22   2    Scan Directory 
                    Information 
 0x2222   22   12   Scan Directory 
                    For Trustees 
 0x2222   22   38   Trustees Scan 
                    Ext 
 0x2222   23   17   Get File Server 
                    Information 
 0x2222   87   02   Initialize 
                    Search 
 0x2222   87   03   Search For File 
                    or Subdirectory 
 0x2222   87   05   Scan File Or 
                    Subdirectory 
                    For Trustees 
 0x2222   87   06   Obtain File or 
                    Subdirectory 
                    Information 

References

NWDeleteTrusteeFromDirectory(3nw), NWAddTrustee(3nw), NWScanForTrustees(3nw)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.