AddClusterNode function (clusapi.h)

Adds a node to an existing cluster. The PCLUSAPI_ADD_CLUSTER_NODE type defines a pointer to this function.


HNODE AddClusterNode(
  [in]           HCLUSTER                         hCluster,
  [in]           PCWSTR                           lpszNodeName,
  [in, optional] PCLUSTER_SETUP_PROGRESS_CALLBACK pfnProgressCallback,
  [in, optional] PVOID                            pvCallbackArg


[in] hCluster

Handle to a cluster, returned by the OpenCluster or CreateCluster function.

[in] lpszNodeName

Name of the computer to add to the cluster.

[in, optional] pfnProgressCallback

Optional address to a PCLUSTER_SETUP_PROGRESS_CALLBACK callback function.

[in, optional] pvCallbackArg

Argument for the callback function.

Return value

Handle to the new node or NULL to indicate that the node was not successfully added to the cluster. For more information about the error, call the GetLastError function.


After the CreateCluster function successfully completes, at least 30 seconds should be allowed before the AddClusterNode function is called to add additional nodes.


Minimum supported client None supported
Minimum supported server Windows Server 2008 Datacenter, Windows Server 2008 Enterprise
Target Platform Windows
Header clusapi.h
Library ClusAPI.lib
DLL ClusAPI.dll

See also


Node Management Functions