AddClusterResourceNode function (clusapi.h)

Article
02/22/2024

Adds a node to the list of possible nodes that a resource can run on. The PCLUSAPI_ADD_CLUSTER_RESOURCE_NODE type defines a pointer to this function.

Syntax

DWORD AddClusterResourceNode(
  [in] HRESOURCE hResource,
  [in] HNODE     hNode
);

Parameters

[in] hResource

Handle to a resource that will add a node to its possible owners list.

[in] hNode

Handle to the node to be added to the list of potential host nodes belonging to the resource identified by hResource.

Return value

If the operation succeeds, it returns ERROR_SUCCESS.

If the operation fails, AddClusterResourceNode returns one of the system error codes.

Remarks

Do not pass LPC and RPC handles to the same function call. Otherwise, the call will raise an RPC exception and can have additional destructive effects. For information on how LPC and RPC handles are created, see Using Object Handles and OpenCluster.

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