Scans a set of directory and file entry information by using a specific name space.
#include <nwnamspc.h>
or
#include <nwcalls.h>
NWCCODE NWScanNSEntryInfoSet (
NWCONN_HANDLE conn,
NWDIR_HANDLE dirHandle,
nuint8 buNameSpace,
nuint16 suAttr,
SEARCH_SEQUENCE N_FAR *pIterHnd,
const nstr8 N_FAR *pbstrSrchPattern,
nuint32 luRetMask,
pnuint8 pbuMoreEntriesFlag,
punint16 psuNumReturned,
nuint16 suNumItems,
NW_ENTRY_INFO N_FAR *pEntryInfo);
(IN) Specifies the NetWare server connection handle.
(IN) Specifies the directory handle associated with the directory to be scanned (must be the parent directory handle).
(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 which information is to be returned in the array pointed to by pEntryInfo (see Section 20.6, Basic Return Mask Values-this parameter cannot take Extended Return Mask Values).
(OUT) Points to a flag indicating whether more entries are avilable:
(OUT) Points to a value indicating how many NW_ENTRY_INFO structures were actually returned in the pEntryInfo array.
(IN) Specifies the size of the array pointed to by pEntryInfo.
(OUT) Points to an array of NW_ENTRY_INFO structures.
These are common return values; see Return Values (Return Values for C) for more information.
NWScanNSEntryInfoSet is a version of NWScanNSEntryInfo that has been enhanced to return a list of entry information.
For the first request, the searchDirNumber field in SEARCH_SEQUENCE should be set to -1. Thereafter, the server manages the information; users should never directly change the value.