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.