NWIntScanExtendedInfo(3nw)

NWIntScanExtendedInfo -- scans a directory for the extended file information

Synopsis

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

NWCCODE N_API NWIntScanExtendedInfo (NWCONN_HANDLE conn, NWDIR_HANDLE dirHandle, nuint8 attrs, pnuint32 iterHandle, pnstr8 searchPattern, NW_EXT_FILE_INFO N_FAR entryInfo, nuint16 augmentFlag);

Description

The parameters are as follows:

conn: (IN) Specifies the NetWare server connection handle.
dirHandle: (IN) Specifies the NetWare directory handle for the directory to be scanned.
attrs: (IN) Specifies the search attributes.
iterHandle: (IN/OUT) Points to the search sequence number. Set this to 0xFFFFFFFF initially.
searchPattern: (IN) Points to the pattern for which to search (no wildcards are allowed).
entryInfo: (OUT) Points to NW_EXT_FILE_INFO containing the extended 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

NWIntScanExtendedInfo is replacing NWScanExtendedInfo.

NWIntScanExtendedInfo works only on files; it does not work on directories.

All scanning is complete when the server returns 0x89FF.

NWIntScanExtendedInfo is synonymous with NWIntScanDirEntryInfo and uses an extension of the information structure.

iterHandle should point to -1 for the first call.

attrs is used to include system and/or hidden files. In other words, if only the system bit is set in attrs, 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 designated either hidden or system are affected.

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

attrs values follow:

C Value Value Name

0x00 FA_NORMAL

0x02 FA_HIDDEN

0x04 FA_SYSTEM

0x10 FA_DIRECTORY

C Value	Value Name
0x00	FA_NORMAL
0x02	FA_HIDDEN
0x04	FA_SYSTEM
0x10	FA_DIRECTORY

 
 ------------------------- 
| C Value|  Value Name   | 
|--------|---------------| 
| 0x00   |  FA_NORMAL    | 
|--------|---------------| 
| 0x02   |  FA_HIDDEN    | 
|--------|---------------| 
| 0x04   |  FA_SYSTEM    | 
|--------|---------------| 
| 0x10   |  FA_DIRECTORY | 
|--------|---------------|

The extended file information contains the information returned by NWIntScanDirEntryInfo plus the sizes of the data and resource forks. Additionally, NWIntScanExtendedInfo returns the physical size of a file.

NOTE: In the case of sparse files, the logical size may be much larger than the physical size.

Services

File Systems

NCP calls

0x2222 22 40: Scan Directory Disk Space

References

NWIntScanDirEntryInfo(3nw), NWScanNSEntryInfo(3nw)