Obtains directory entry information, using a specific name space and UTF-8 strings.
#include <nwnamspc.h>
or
#include <nwcalls.h>
NWCCODE N_API NWScanNSEntryInfoExt (
NWCONN_HANDLE conn,
nuint8 dirHandle,
nuint8 namSpc,
nuint16 attrs,
SEARCH_SEQUENCE N_FAR *sequence,
const nstr8 N_FAR *srchPattern,
nuint32 retInfoMask,
NW_ENTRY_INFO_EXT N_FAR *entryInfo);
(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_EXT.
These are common return values; see Return Values (Return Values for C) for more information.
NWScanNSEntryInfoExt 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 NWScanNSEntryInfoExt.
To request information from a server, a client sets the appropriate bit or bits of retInfoMask and sends a request packet to the server.