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.