NWIntFileSearchContinue(3nw)


NWIntFileSearchContinue -- iteratively retrieves all specified directory entries

Synopsis

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

NWCCODE N_API NWIntFileSearchContinue (NWCONN_HANDLE conn, nuint8 volNum, nuint16 dirID, nuint16 searchContext, nuint8 searchAttr, pnstr8 searchPath, pnuint8 retBuf, nuint16 augmentFlag);

Description

The parameters are as follows:

conn
(IN) Specifies the NetWare server connection handle.

volNum
(IN) Specifies the volume number returned by the initialize function.

dirID
(IN) Specifies the directory ID returned by the initialize function.

searchContext
(IN) Specifies the sequence number returned by NWIntFileSearchInitialize.

searchAttr
(IN) Specifies the attributes to apply to the search.

searchPath
(IN) Points to the path (filename, directory name, or wildcard).

retBuf
(OUT) Points to the information returned by the server.

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

0x8998
VOLUME_DOES_NOT_EXIST

0x89FF
NO_FILES_FOUND_ERROR

Notices

NWIntFileSearchContinue is replacing NWFileSearchContinue.

Perform the actual search initialized with NIntFileSearchInitialize. On the first iteration, use the sequence number returned by NWIntFileSearchInitialize. For subsequent iterations, use iterHnd from SEARCH_FILE_INFO or SEARCH_DIR_INFO.

searchPath can point to wildcards.

NWIntFileSearchContinue returns two different search structures depending on whether the match is a directory or a file. The application is responsible for determining the type of match, or for limiting the search to files or directories only. The two search structures are SEARCH_FILE_INFO and SEARCH_DIR_INFO.

Search attributes 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| 
|--------|--------------| 

Services

File Systems

NCP calls

0x2222 63
File Search Continue

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