GetClusterFromNode function (clusapi.h)

Returns a handle to the cluster associated with a node. The PCLUSAPI_GET_CLUSTER_FROM_NODE type defines a pointer to this function.

Syntax

HCLUSTER GetClusterFromNode(
  [in] HNODE hNode
);

Parameters

[in] hNode

Handle to the node.

Return value

If the operation succeeds, the function returns a handle to the cluster that owns the node.

If the operation fails, the function returns NULL. For more information about the error, call GetLastError.

Remarks

For hNode to be a valid handle, there must necessarily be an open cluster handle (see OpenClusterNode). GetClusterFromNode returns another instance of the handle from which hNode was obtained.

Be sure to call CloseCluster on the handle returned from GetClusterFromNode before the handle goes out of scope. Closing this handle does not invalidate hNode or the cluster handle from which hNode was obtained.

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

See also

CloseCluster

CloseClusterNode

GetClusterFromGroup

GetClusterFromNetInterface

GetClusterFromNetwork

GetClusterFromResource

OpenCluster

OpenClusterNode