NWScanNSEntryInfo(3nw)

NWScanNSEntryInfo -- obtains directory entry information using a name space

Synopsis

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

NWCCODE N_API NWScanNSEntryInfo (NWCONN_HANDLE conn, nuint8 dirHandle, nuint8 namSpc, nuint16 attr, SEARCH_SEQUENCE N_FAR sequence, pnstr8 srchPattern, nuint32 retInfoMask, NW_ENTRY_INFO N_FAR entryInfo);

Description

The parameters are as follows:

conn: (IN) Specifies the NetWare server connection handle.
dirHandle: (IN) Specifies the directory handle associated with the directory to scan. Must point to the parent directory.
namSpc: (IN) Specifies the name space of dirHandle.
attr: (IN) Specifies the attributes to be used for the scan.
sequence: (IN/OUT) Points to SEARCH_SEQUENCE.
srchPattern: (IN) Points to the name of the entry for which to scan (wildcards are allowed).
retInfoMask: (IN) Specifies the information to return.
entryInfo: (OUT) Points to NW_ENTRY_INFO.

Return values

0x0000: SUCCESSFUL
0x8801: INVALID_CONNECTION
0x8998: VOLUME_DOES_NOT_EXIST
0x899B: BAD_DIRECTORY_HANDLE
0x899C: INVALID_PATH

Notices

NWScanNSEntryInfo can be used iteratively with wild cards. On the first call, searchDirNumber in the SEARCH_SEQUENCE structure should be set to -1. After that, the server manages the information.

retInfoMask is used to determine which fields of NW_ENTRY_INFO to return. nameLength and entryName are always returned in NWScanNSEntryInfo.

To request information from a server, a client sets the appropriate bit or bits of retInfoMask and sends a request packet to the server. retInfoMask values follow:

0x0001L: IM_NAME
0x0001L: IM_ENTRY_NAME
0x0002L: IM_SPACE_ALLOCATED
0x0004L: IM_ATTRIBUTES
0x0008L: IM_SIZE
0x0010L: IM_TOTAL_SIZE
0x0020L: IM_EA
0x0040L: IM_ARCHIVE
0x0080L: IM_MODIFY
0x0100L: IM_CREATION
0x0200L: IM_OWNING_NAMESPACE
0x0400L: IM_DIRECTORY
0x0800L: IM_RIGHTS
0x0FEDL: IM_ALMOST_ALL
0x0FFFL: IM_ALL
0x1000L: IM_REFERENCE_ID
0x2000L: IM_NS_ATTRIBUTES
0x4000L: IM_DATASTREAM_SIZES
0x80000000L: IM_COMPRESSED_INFO
0x80000000L: IM_NS_SPECIFIC_INFO

Possible attr values follow:

0x00: FA_NORMAL
0x01: FA_READ_ONLY
0x02: FA_HIDDEN
0x04: FA_SYSTEM
0x08: FA_EXECUTE_ONLY
0x10: FA_DIRECTORY
0x20: FA_NEEDS_ARCHIVED
0x80: FA_SHAREABLE

Services

Name Space

NCP calls

0x2222 87 02 Initialize Search

0x2222 87 03 Search For File Or Subdirectory

 
 0x2222   87   02   Initialize 
                    Search 
 0x2222   87   03   Search For File 
                    Or Subdirectory

References

NWGetNSEntryInfo(3nw)

0x2222	87	02	Initialize Search
0x2222	87	03	Search For File Or Subdirectory