Obtains directory entry information, returning more information and using network bandwidth more efficiently than the NWScanNSEntryInfo function.
#include <nwnamspc.h>
or
#include <nwcalls.h>
N_EXTERN_LIBRARY(NWCCODE) NWScanNSEntryInfo2 (
NWCONN_HANDLE conn,
nuint8 dirHandle,
nuint8 namSpc,
nuint16 attrs,
SEARCH_SEQUENCE N_FAR *sequence,
const nstr8 N_FAR *srchPattern,
nuint32 retInfoMask,
NW_ENTRY_INFO2 N_FAR *entryInfo);
Function NWScanNSEntryInfo2 (
conn : NWCONN_HANDLE;
dirHandle:nuint8;
namSpc: nuint8;
attrs : nuint16;
Var sequence : SEARCH_SEQUENCE;
const srchPattern : pnstr8;
retInfoMask : nuint32;
Var entryInfo : NW_ENTRY_INFO2
) : NWCCODE;
(IN) Specifies the NetWare server connection handle.
(IN) Specifies the directory handle associated with the directory to scan (must be valid and cannot be zero).
(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 Section 20.7, Extended Return Mask Values).
(OUT) Points to the NW_ENTRY_INFO2 structure.
These are common return values; see Return Values (Return Values for C) for more information.
NWScanNSEntryInfo2 can be used iteratively with wildcards. On the first iteration, set searchDirNumber in the SEARCH_SEQUENCE structure to -1. After that, the server manages the information.
The retInfoMask parameter is used to determine which fields of NW_ENTRY_INFO2 to return; nameLength and entryName are always returned in NWScanNSEntryInfo2.
To request information from a server, a client sets the appropriate bit or bits of retInfoMask and sends a request packet to the server.