NWScanPhysicalLocksByFile(3nw)
NWScanPhysicalLocksByFile --
scans for record locks in physical file
Synopsis
#include <nwsync.h>
or
#include <nwcalls.h>
NWCCODE N_API NWScanPhysicalLocksByFile
(NWCONN_HANDLE conn,
NWDIR_HANDLE dirHandle,
pnstr8 path,
nuint8 dataStream,
pnint16 iterHandle,
PHYSICAL_LOCK N_FAR
lock,
PHYSICAL_LOCKS N_FAR
locks);
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.
- path
-
(IN) Points to a full file path (or a path relative to dirHandle)
specifying the file to be checked.
- dataStream
-
(IN) Specifies the data stream to use for scan (for 3.11 and above only).
- iterHandle
-
(IN/OUT) Points to the next record to be scanned; must be set to 0 initially.
- lock
-
(OUT) Points to PHYSICAL_LOCK(optional).
- locks
-
(OUT) Points to PHYSICAL_LOCKS.
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
- 0x89FD
-
BAD_STATION_NUMBER
- 0x89FF
-
NO_FILES_FOUND_ERROR
Notices
The client must have console operator rights to call
NWScanPhysicalLocksByFile.
iterHandle returns -1 upon completion, and should not be changed
during the scan.
If lock is a NULL pointer, locks returns the
records in groups, instead of one by one.
Services
Synchronization
NCP calls
0x2222
|
23
|
17
|
Get File Server Information
|
0x2222
|
23
|
222
|
Get Physical Record Locks By File (2.x)
|
0x2222
|
23
|
238
|
Get Physical Record Locks By File (3.x-4.x)
|
0x2222
|
23
|
244
|
Convert Path to Entry
|
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.