Arbitrate

The Arbitrate entry point function allows a node to attempt to regain ownership of a quorum resource.

DWORD WINAPI Arbitrate(
  RESID ResourceId,                          
  PQUORUM_RESOURCE_LOST LostQuorumResource   
);
 

Parameters

ResourceId

[in] Resource identifier for the quorum resource to be owned.

LostQuorumResource

[in] Pointer to a callback function that should be called if the arbitration fails and control of the quorum resource is lost after being successfully gained.

Return Values

ERROR_SUCCESS

The arbitration was successful and the quorum resource remains defended.

Win32 error code

The arbitration was not successful.

Notes to Implementers

Arbitrate is implemented for quorum resources only. Expect this entry point function to be called only after both Startup and Open have been called.

Implementations of Arbitrate should take less than 300 milliseconds to complete.

If Arbitrate is successful, make sure that only the current node can successfully arbitrate for the quorum resource represented by ResourceId. For example, a disk resource can implement a defense by continually replacing the reservation made on it once per second.

QuickInfo

  Version: Use Windows NT Server Enterprise Edition 4.0.
  Windows CE: Unsupported.
  Header: Declared in resapi.h.