NWFileSearchInitialize(3nw)


NWFileSearchInitialize -- searches for files on a server

Synopsis

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

NWCCODE N_API NWFileSearchInitialize (NWCONN_HANDLE conn, NWDIR_HANDLE dirHandle, pnstr8 path, pnuint8 volNum, pnuint16 dirID, pnuint16 iterHnd, pnuint8 accessRights);

Description

The parameters are as follows:

conn
(IN) Specifies the NetWare server connection handle.

dirHandle
(IN) Specifies the base directory handle to search.

path
(IN) Points to the path (relative to dirHandle) on which to initialize the search.

volNum
(OUT) Points to the corresponding volume number.

dirID
(OUT) Points to the directory ID corresponding to the specified path.

iterHnd
(OUT) Points to a sequence number to be used in calling NWFileSearchContinue.

accessRights
(OUT) Points to the workstation's access rights to the specified directory.

Return values

0x0000
SUCCESSFUL

0x8801
INVALID_CONNECTION

0x8998
VOLUME_DOES_NOT_EXIST

0x899B
BAD_DIRECTORY_HANDLE

0x899C
INVALID_PATH

Notices

NWFileSearchInitialize and NWIntFileSearchInitialize, also contained in nwfile.h, are duplicate functions. Only NWFileSearchInitialize is documented.

If the directory handle is unknown, a value of 0 should be passed. In the absence of the directory handle, the path needs to specify the volume as well.

iterHnd should initially point to a value of -1.

Services

File Systems

NCP calls

0x2222 62
File Search Initialize

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