LockLogicalRecordSet
Attempts to lock all the logical records in the log table
#include <\nlm\nit\nwsync.h>
int LockLogicalRecordSet (
WORD timeoutLimit);
For cross-platform functionality, call NWLockLogicalRecordSet.
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 or can access 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.
The timeoutLimit parameter indicates how long the server should wait if it cannot lock all the records immediately. The timeoutLimit is specified in units of 1/18 of a second (0 means no wait).
The function cannot lock a logical record that is already exclusively locked by another application. Therefore, if one or more logical records identified in the log table are already exclusively locked by another application, the attempt fails.