NWClearPhysicalRecord(3nw)
NWClearPhysicalRecord --
unlocks the specified physical record and removes it from the log table
Synopsis
#include <nwfile.h>
or
#include <nwcalls.h>
NWCCODE N_API NWClearPhysicalRecord
(NWFILE_HANDLE fileHandle,
nuint32 recStartOffset,
nuint32 recSize);
Description
The parameters are as follows:
- fileHandle
-
(IN) Specifies the file handle associated with the file containing the physical record being cleared.
- recStartOffset
-
(IN) Specifies the offset, from the beginning of the file, at which the record starts.
- recSize
-
(IN) Specifies the length, in bytes, of the locked record.
Return values
- 0x0000
-
SUCCESSFUL
- 0x8988
-
INVALID_FILE_HANDLE
- 0x89FF
-
LOCK_ERROR
Notices
NWClearPhysicalRecord locates the physical record within the specified file by passing the offset in recStartOffset and the length in recSize.
NOTE:
Locking or unlocking a logical record does not physically lock or unlock those resources associated with the logical record; only the applications using the record know about
such an association.
recStartOffset and recSize should match the corresponding parameters in NWLogPhysicalRecord.
NWClearPhysicalRecord is ignored if the requesting workstation does not have logged physical records.
Services
Synchronization
NCP calls
- 0x2222 30
-
Sync Clear Physical Record
References
NWClearPhysicalRecordSet(3nw),
NWLockPhysicalRecordSet(3nw),
NWLogPhysicalRecord(3nw),
NWReleasePhysicalRecord(3nw),
NWReleasePhysicalRecordSet(3nw)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.