NWClearFileLockSet

Unlocks all files logged in the File Log Table and removes 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 )NWClearFileLockSet  ( 
     void);
  

Delphi Syntax

  uses calwin32 
   
  Function NWClearFileLockSet 
    : NWCCODE;
  

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

Remarks

To avoid deadlock, a workstation must request those resources it needs to lock by making an entry in the File Log Table at the NetWare server. Once the log table is complete, the application attempts to lock those records. Locking works only if all records in the table are available. If some of the logged resources cannot be locked, the lock fails and none of the resources are locked.

All open files in the task’s log table are closed. The file handles on the workstation itself are not cleared—this should be done by the application and any error codes should be ignored. NWClearFileLockSet is ignored if the associated task on the workstation does not have logged files.

NCP Calls

See Also

NWClearFileLock2, NWLogFileLock2, NWReleaseFileLock2, NWReleaseFileLockSet