NWReleaseLogicalRecordSet

Unlocks all the logical records but does not remove them from the log table

Local Servers:blocking
Remote Servers:blocking
NetWare Server:3.11, 3.12, 3.2, 4.x, 5.x, 6.x
Platform:NLM, Windows NT, Windows 95, Windows 98
Library:Cross-Platform NetWare Calls (CAL*.*)
Service:Synchronization

Syntax

  #include <nwfile.h> 
  or 
  #include <nwcalls.h> 
   
  N_EXTERN_LIBRARY( NWCCODE )NWReleaseLogicalRecordSet  ( 
     void);
  

Delphi Syntax

  uses calwin32 
   
  Function NWReleaseLogicalRecordSet 
    : NWCCODE;
  

Return Values

These are common return values; see Return Values (NDK: Connection, Message, and NCP Extensions) for more information.

0x0000

SUCCESSFUL

Remarks

A logical record is simply a name (a string) registered with the NetWare server. The name (as with a semaphore) can then be locked or unlocked by applications and can be used as an inter-application locking mechanism.

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.

To avoid deadlock, a workstation is required to request those files it needs to lock; it does so by making an entry into the File Log Table at the NetWare server. Once the log table is complete, the application can then lock those files. The locking works only if all files in the table are available.

NWReleaseLogicalRecordSet is ignored if the requesting workstation or process does not have locked logical records.

NCP Calls

See Also

NWClearLogicalRecord, NWClearLogicalRecordSet, NWLockLogicalRecordSet, NWLogLogicalRecord, NWReleaseLogicalRecord