NWIntScanFileInformation2(3nw)


NWIntScanFileInformation2 -- returns DOS name space directory entry information

Synopsis

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

NWCCODE N_API NWIntScanFileInformation2 (NWCONN_HANDLE conn, NWDIR_HANDLE dirHandle, pnstr8 filePattern, nuint8 searchAttrs, pnuint8 iterHandle, NW_FILE_INFO2 N_FAR * info, nuint16 augmentFlag);

Description

The parameters are as follows:

conn
(IN) Specifies the NetWare server connection handle.

dirHandle
(IN) Specifies the NetWare directory handle relative to filePattern.

filePattern
(IN) Points to the string containing the file name or wildcard pattern to use in the search.

searchAttrs
(IN) Specifies the attributes to use for searching.

iterHandle
(IN/OUT) Points to the sequence number upon input. Set the first 4 bytes to 0xFF for the first iteration. Points the 9-byte sequence number to be used for subsequent iterations upon output.

info
(OUT) Points to NW_FILE_INFO2 containing the file information.

augmentFlag
(IN) Specifies if wildcards are augmented:

0
wildcards are not augmented

non-zero
all wildcards are augmented

Return values

0x0000
SUCCESSFUL

0x8801
INVALID_CONNECTION

0x8989
NO_SEARCH_PRIVILEGES

0x8998
VOLUME_DOES_NOT_EXIST

0x899B
BAD_DIRECTORY_HANDLE

0x899C
INVALID_PATH

0x89FF
NO_FILES_FOUND_ERROR

Notices

NWIntScanFileInformation2 is replacing NWScanFileInformation2.

dirHandle can be zero if filePattern points to the complete path, including the volume name.

searchAttrs includes system and/or hidden files. In other words, if only the system bit is set in searchAttrs, all files are affected except hidden files. If only the hidden bit is set, all files are affected except system files. When neither bit is set (0x00), only files that are not designated either hidden or system are affected.


NOTE: A file is designated hidden or system if its corresponding file attribute is set.

searchAttrs follow:

0x00
FA_NORMAL

0x02
FA_HIDDEN

0x04
FA_SYSTEM

0x10
FA_DIRECTORY
iterHandle points to a 9-byte identifier the server uses as an index for searching In the first call to NWIntScanFileInformation2, the first 4 bytes of the number need to be set to 0xFF. This can be done by typecasting the pointer to an nuint32, and assigning -1, or 0xFFFFFFFF to it. Every time NWIntScanFileInformation2 is called, the sequence number for the next iteration is returned.

Services

File Systems

NCP calls

0x2222 23 15
Scan File Information

0x2222 23 17
Get File Server Information

0x2222 87 02
Initialize Search

0x2222 87 03
Search For File Or Subdirectory

30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.