Novell Documentation: NLM & NetWare Libraries for C

NWClearPhysicalRecord

Unlocks the specified physical record and removes 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 )NWClearPhysicalRecord  ( 
     NWFILE_HANDLE   fileHandle,  
     nuint32         recStartOffset,  
     nuint32         recSize);

Delphi Syntax

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

Parameters

fileHandle: (IN) Specifies the file handle associated with the file containing the physical record being cleared.
recStartOffset: (IN) Specifies the offset, from the beginning of the file, at which the record starts.
recSize: (IN) Specifies the length, in bytes, of the locked record.

Return Values

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

0x0000	SUCCESSFUL
0x8988	INVALID_FILE_HANDLE
0x89FF	LOCK_ERROR

Remarks

NWClearPhysicalRecord locates the physical record within the specified file by passing the offset in recStartOffset and the length in recSize.

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.

recStartOffset and recSize should match the corresponding parameters in NWLogPhysicalRecord.

NWClearPhysicalRecord is ignored if the requesting workstation does not have logged physical records.

NCP Calls

0x2222 30 Sync Clear Physical Record