Arbitrate callback function

Allows a node to attempt to regain ownership of a quorum resource. The PARBITRATE_ROUTINE type defines a pointer to this function.

Syntax


DWORD WINAPI Arbitrate(
  _In_  RESID Resource,
  _In_  PQUORUM_RESOURCE_LOST LostQuorumResource
);

typedef DWORD (WINAPI *PARBITRATE_ROUTINE)(
    _In_  RESID Resource,
    _In_  PQUORUM_RESOURCE_LOST LostQuorumResource
);

Parameters

Resource [in]

Resource identifier for the quorum resource to be owned.

LostQuorumResource [in]

Address of a QuorumResourceLost callback function that should be called if control of the quorum resource is lost after being successfully gained.

Return value

Return code/valueDescription
ERROR_SUCCESS
0

The arbitration was successful and the quorum resource remains defended.

Error code

The arbitration was not successful.

 

Remarks

The Arbitrate entry-point function is implemented for quorum resources only. Expect this 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.

Requirements

Minimum supported client

None supported

Minimum supported server

Windows Server 2003 Enterprise, Windows Server 2003 Datacenter

Header

ResApi.h

See also

Resource DLL Entry-Point Functions

 

 

Show:
© 2014 Microsoft