AddClusterNode function (clusapi.h)

Article
02/22/2024

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

Syntax

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

Parameters

[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.

Remarks

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

Requirements

Requirement	Value
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