FailClusterResource

The FailClusterResource function initiates a resource failure.

DWORD WINAPI FailClusterResource(
  HRESOURCE hResource  
);
 

Parameters

hResource

[in] Handle to the resource that is the target of the failure.

Return Values

ERROR_SUCCESS

The operation was successful.

If the operation was unsuccessful, FailClusterResource returns a Win32 error value.

Remarks

The resource identified by hResource is treated as inoperable, causing the cluster to initiate the same failover process that would result if the resource had actually failed. Applications call FailClusterResource to test their policies for restarting resources and groups.

QuickInfo

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