Syntax

  #include <nwfile.h> 
  or 
  #include <nwcalls.h> 
   
  N_EXTERN_LIBRARY( NWCCODE )NWReleasePhysicalRecord  ( 
     NWFILE_HANDLE   fileHandle,  
     nuint32         recStartOffset,  
     nuint32         recSize);
  

Delphi Syntax

  uses calwin32 
   
  Function NWReleasePhysicalRecord 
    (fileHandle : NWFILE_HANDLE; 
     recStartOffset : nuint32; 
     recSize : nuint32 
  ) : NWCCODE;
  

Parameters

fileHandle

(IN) Specifies the file handle associated with the file containing the specified record.

recStartOffset

(IN) Specifies the offset, within the file, where the physical record begins.

recSize

(IN) Specifies the length, in bytes, of the record being released.

Return Values

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

Remarks

A physical record lock, as opposed to a logical lock, is the actual lock of a specified record relative to a physical file. When a record is locked, it is also entered into a log table. Records are allowed to be locked only if all records in the log table are available for locking. This is done to avoid deadlock.

NWReleasePhysicalRecord is ignored if the requesting workstation or process does not have locked physical records.

NCP Calls

• 0x2222 28 Release Physical Record

See Also

NWClearPhysicalRecord, NWClearPhysicalRecordSet, NWLockPhysicalRecordSet, NWLogPhysicalRecord, NWReleasePhysicalRecordSet