NWScanPhysicalLocksByConnFile(3nw)
NWScanPhysicalLocksByConnFile --
scans for physical record locks on file
Synopsis
#include <nwsync.h>
or
#include <nwcalls.h>
NWCCODE N_API NWScanPhysicalLocksByConnFile
(NWCONN_HANDLE conn,
NWCONN_NUM connNum,
NWDIR_HANDLE dirHandle,
pnstr8 path,
nuint8 dataStream,
pnint16 iterHandle,
CONN_PHYSICAL_LOCK N_FAR * lock,
CONN_PHYSICAL_LOCKS N_FAR * locks);
Description
The parameters are as follows:
- conn
-
(IN) Specifies the NetWare server connection handle.
- connNum
-
(IN) Specifies the connection number of the logged-in object to be scanned.
- 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. The last item must be a file name.
- dataStream
-
(IN) Specifies the data stream to use (3.11 and above only).
- iterHandle
-
(IN/OUT) Points to the number of the next record to be scanned; should
be set to 0 initially.
- lock
-
(OUT) Points to CONN_PHYSICAL_LOCK.
- locks
-
(OUT) Points to CONN_PHYSICAL_LOCKS.
Return values
- 0x0000
-
SUCCESSFUL
- 0x8801
-
INVALID_CONNECTION
- 0x88FF
-
Scan Completed
- 0x89C6
-
NO_CONSOLE_PRIVILEGES
- 0x8996
-
SERVER_OUT_OF_MEMORY
- 0x89FD
-
BAD_STATION_NUMBER
- 0x89FF
-
FILE_NAME_ERROR, NO_FILES_FOUND_ERROR
Notices
The client must have console operator rights to call
NWScanPhysicalLocksByConnFile.
For 2.x, path cannot be longer than 14 bytes including the
NULL character.
iterHandle returns -1 upon completion and must not be changed
during the scan.
If lock is a NULL pointer, locks returns
the records in groups, instead of one by one. Both are described below.
Services
Synchronization
NCP calls
0x2222
|
23
|
17
|
Get File Server Information
|
0x2222
|
23
|
221
|
Get Physical Record Locks By Connection And File (2.x)
|
0x2222
|
23
|
237
|
Get Physical Record Locks By Connection And File (3.x-4.x)
|
0x2222
|
23
|
244
|
Convert Path To Entry
|
0x2222
|
62
|
-
|
Scan First
|
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.