NWScanConnectionsUsingFile(3nw)


NWScanConnectionsUsingFile -- scans connections using file

Synopsis

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

NWCCODE N_API NWScanConnectionsUsingFile (NWCONN_HANDLE conn, NWDIR_HANDLE dirHandle, pnstr8 filePath, pnint16 iterHandle, CONN_USING_FILE N_FAR * fileUse, CONNS_USING_FILE N_FAR * fileUsed);

Description

The parameters are as follows:

conn
(IN) Specifies the NetWare server connection handle.

dirHandle
(IN) Specifies the directory handle associated with the desired directory path.

filePath
(IN) Points to a full file path (or a path relative to dirHandle) specifying the file to be checked. Wildcards are not allowed.

iterHnd
(IN/OUT) Points to the next record to be scanned.

fileUse
(OUT) Points to CONN_USING_FILE.

fileUsed
(OUT) Points to CONNS_USING_FILE.

Return values

0x0000
SUCCESSFUL

0x8801
INVALID_CONNECTION

0x88FF
Scan Completed

0x8996
SERVER_OUT_OF_MEMORY

0x8998
VOLUME_DOES_NOT_EXIST

0x899B
BAD_DIRECTORY_HANDLE

0x899C
INVALID_PATH

0x89C6
NO_CONSOLE_PRIVILEGES

Notices

The client must have console operator rights to call NWScanConnectionsUsingFile.

iterHnd should point to 0 initially. Upon each subsequent call, the number of the next record to be scanned is returned.

NWScanConnectionsUsingFile returns -1 upon completion. The value should not be changed during the scan.

If no connections are using the specified file, NWScanConnectionsUsingFile will not return an error. Instead, if no connections are using the file and fileUse is NULL, the structure returned by fileUse will contain zeroes. Check connCount in the structure returned by fileUsed to see the number of connections actually using the file.

If fileUse is NULL, the records are returned in fileUsed in groups, instead of one by one.

Services

File Systems

NCP calls

0x2222 23 17 Get File Server Information
0x2222 23 220 Get Connections Using A File (2.x)
0x2222 23 236 Get Connections Using A File (3.x-4.x)
0x2222 23 244 Convert Path To Dir Entry

 
 0x2222   23   17    Get File Server 
                     Information 
 0x2222   23   220   Get Connections 
                     Using A File 
                     (2.x) 
 0x2222   23   236   Get Connections 
                     Using A File 
                     (3.x-4.x) 
 0x2222   23   244   Convert Path To 
                     Dir Entry 

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