NWReleaseLogicalRecord

Unlocks a logical record but does not remove it 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) NWReleaseLogicalRecord ( 
     NWCONN_HANDLE       conn,  
     const nstr8 N_FAR  *logRecName);
  

Delphi Syntax

  uses calwin32 
   
  Function NWReleaseLogicalRecord 
    (conn : NWCONN_HANDLE; 
     logRecName : pnstr8 
  ) : NWCCODE;
  

Parameters

conn
(IN) Specifies the NetWare server connection handle containing the logical record.
logRecName
(IN) Points to the name of the logical record being released (128 characters).

Return Values

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

0x0000

SUCCESSFUL

0x8801

INVALID_CONNECTION

0x890A

NLM_INVALID_CONNECTION

0x89FF

LOCK_ERROR

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.

File Log Table contains data locking information used by a NetWare server. The NetWare server tracks this information for each workstation and workstation task. Whenever a file, logical record, or physical record is logged, information identifying the data being logged is placed in the File Log Table. Normally, a set of files or records is logged and then locked as a set. However, a single file or record can also be locked when it is placed in the table.

NWReleaseLogicalRecord is ignored if the requesting workstation has no records to release.

NCP Calls

See Also

NWClearLogicalRecord, NWClearLogicalRecordSet, NWLockLogicalRecordSet, NWReleaseLogicalRecordSet