GetClusterNodeState function (clusapi.h)
Returns the current state of a node. The PCLUSAPI_GET_CLUSTER_NODE_STATE type defines a pointer to this function.
Syntax
CLUSTER_NODE_STATE GetClusterNodeState(
[in] HNODE hNode
);
Parameters
[in] hNode
Handle to the node for which state information should be returned.
Return value
GetClusterNodeState returns the current state of the node, which is represented by one of the following values.
The returned values are from the CLUSTER_NODE_STATE enumeration.
Return code/value | Description |
---|---|
|
The node is physically plugged in, turned on, booted, and capable of executing programs. |
|
The node is turned off or not operational. |
|
The node is in the process of joining a cluster. |
|
The node is running but not participating in cluster operations. |
|
The operation was not successful. For more information about the error, call the function GetLastError. |
Remarks
The ClusterNodeDown state only indicates that a node is inactive; it does not specify the reason for the inactivity. A node can be in the ClusterNodeDown state for the following reasons:
- The node is not running.
- The Cluster service on the node is not running.
- The node cannot communicate with the node controlling the quorum resource.
- The node is inactive for any other reason.
Requirements
Requirement | Value |
---|---|
Minimum supported client | None supported |
Minimum supported server | Windows Server 2008 Enterprise, Windows Server 2008 Datacenter |
Target Platform | Windows |
Header | clusapi.h |
Library | ClusAPI.lib |
DLL | ClusAPI.dll |