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.