ClearLogicalRecord

Unlocks a logical record and removes 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 ClearLogicalRecord (  
     char   *logicalRecordName); 
  

Parameters

logicalRecordName
(IN) Specifies the string containing the record name (maximum 100 characters, including the NULL terminator).

Return Values

Decimal

Hex

Constant

0

(0x00)

ESUCCESS

255

(0xFF)

ERR_NO_RECORD_FOUND

Remarks

For cross-platform functionality, call ClearLogicalRecord.

The log table resides on the server and is associated exclusively with the requesting task.

Applications define logical record names. A logical record name represents a group of files, physical records, structures, and so on. When LogLogicalRecord or LockLogicalRecordSet locks one or more logical record names, it does not lock the actual files, physical records, structures, and so on associated with each logical record name. It just locks the logical record name. Any uncooperative application can ignore a lock on the logical record name and directly lock or access physical files or records. Therefore, applications using logical record locks must not use other locking techniques simultaneously.

See Also

ClearLogicalRecordSet, LockLogicalRecordSet, LogLogicalRecord, ReleaseLogicalRecord, ReleaseLogicalRecordSet