(IN) Specifies the NetWare server connection handle.
dirHandle
(IN) Specifies the directory handle associated with the desired name space (optional).
path
(IN) Points to the valid DOS path (pointing to a directory or file).
srcNamSpc
(IN) Specifies the name space of dirHandle/path.
dstNamSpc
(IN) Specifies the name space for the return information.
searchAttrs
(IN) Specifies the search attributes to use.
retInfoMask
(IN) Specifies the information to return.
entryInfo
(OUT) Points to NW_ENTRY_INFO. Only fields related to retInfoMask are valid.
Return values
0x0000
SUCCESSFUL
0x8801
INVALID_CONNECTION
0x8998
VOLUME_DOES_NOT_EXIST
0x899B
BAD_DIRECTORY_HANDLE
0x899C
INVALID_PATH
0x89BF
INVALID_NAME_SPACE
0x89FF
Bad Parameter---no constant
Notices
dirHandle can be zero if path contains the complete path, including the volume name. dirHandle and/or path contains the entry name
according to srcNamSpc This information is returned for dstNamSpc.
searchAttrs values follow:
C Value
Value Name
Value Description
0x00
TA_NONE
Specifies no Reads or Writes are allowed.
0x01
TA_READ
Specifies file Reads are allowed.
0x02
TA_WRITE
Specifies file Writes are allowed.
0x04
TA_OPEN
Specifies files can be opened; obsolete in 3.x and higher.
0x08
TA_CREATE
Specifies files can be created.
0x10
TA_DELETE
Specifies files can be deleted.
0x20
TA_OWNERSHIP
Specifies subdirectories can be created or deleted and trustee rights granted or revoked.
0x40
TA_SEARCH
Specifies the directory can be searched.
0x80
TA_MODIFY
Specifies file attributes can be modified.
0xFB
TA_ALL
Specifies the trustee has all the above rights to the directory.
To request information from a server, a client sets the appropriate bit or bits of retInfoMask and sends a request packet to the server.