(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.