ReleasePhysicalRecord

Unlocks the specified physical record currently locked in the log table but does not remove it from the log table

Local Servers:blocking
Remote Servers:blocking
Classification:3.x, 4.x, 5.x, 6.x
Service:Server-Based Synchronization

Syntax

  #include <\nlm\nit\nwsync.h>  
   
  int ReleasePhysicalRecord (  
     int    fileHandle,  
     long   recordStartOffset,  
     long   recordLength);

Parameters

fileHandle
(IN) Specifies the handle of the file containing the record to be unlocked.
recordStartOffset
(IN) Specifies the offset within the file where the record begins.
recordLength
(IN) Specifies the length of the record in bytes.

Return Values

Decimal

Hex

Constant

0

(0x00)

ESUCCESS

255

(0xFF)

ERR_NO_RECORD_FOUND

No logged record was found with the specified description.

Remarks

For cross-platform functionality, call NWReleasePhysicalRecord.

The log table resides on the server and is associated exclusively with the requesting task. Since the function does not remove the physical record from the log table, the application can relock the physical record without relogging it.

The fileHandle value is returned by a previous open, sopen, creat, or fileno call.

See Also

ClearPhysicalRecord, ClearPhysicalRecordSet, LockPhysicalRecordSet, LogPhysicalRecord, ReleasePhysicalRecordSet