Obtains directory entry information using a specific name space
#include <nwnamspc.h>
or
#include <nwcalls.h>
NWCCODE N_API NWScanNSEntryInfo (
NWCONN_HANDLE conn,
nuint8 dirHandle,
nuint8 namSpc,
nuint16 attrs,
SEARCH_SEQUENCE N_FAR *sequence,
const nstr8 N_FAR *srchPattern,
nuint32 retInfoMask,
NW_ENTRY_INFO N_FAR *entryInfo);
uses calwin32
Function NWScanNSEntryInfo
(conn : NWCONN_HANDLE;
dirHandle : nuint8;
namSpc : nuint8;
attrs : nuint16;
Var sequence : SEARCH_SEQUENCE;
const searchPattern : pnstr8;
retInfoMask : nuint32;
Var entryInfo : NW_ENTRY_INFO
) : NWCCODE;
(IN) Specifies the NetWare server connection handle.
(IN) Specifies the directory handle associated with the directory to scan. Must point to the parent directory.
(IN) Specifies the name space of dirHandle (see Section 20.5, Name Space Flag Values).
(IN) Specifies the attributes to be used for the scan (see Section 20.8, Search Attributes Values).
(IN/OUT) Points to SEARCH_SEQUENCE.
(IN) Points to the name of the entry for which to scan (wildcards are allowed).
(IN) Specifies the information to return (see Section 20.6, Basic Return Mask Values and don't use the Extended Return Mask Values).
(OUT) Points to NW_ENTRY_INFO.
These are common return values; see Return Values (Return Values for C) for more information.
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.