AddClusterNode function

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

Syntax


HNODE WINAPI AddClusterNode(
  _In_     HCLUSTER                         hCluster,
  _In_     PCWSTR                           lpszNodeName,
  _In_opt_ PCLUSTER_SETUP_PROGRESS_CALLBACK pfnProgressCallback,
  _In_opt_ PVOID                            pvCallbackArg
);

typedef HNODE (WINAPI *PCLUSAPI_ADD_CLUSTER_NODE)(
    _In_     HCLUSTER                         hCluster,
    _In_     PCWSTR                           lpszNodeName,
    _In_opt_ PCLUSTER_SETUP_PROGRESS_CALLBACK pfnProgressCallback,
    _In_opt_ PVOID                            pvCallbackArg
);

Parameters

hCluster [in]

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

lpszNodeName [in]

Name of the computer to add to the cluster.

pfnProgressCallback [in, optional]

Optional address to a PCLUSTER_SETUP_PROGRESS_CALLBACK callback function.

pvCallbackArg [in, optional]

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

Minimum supported client

None supported

Minimum supported server

Windows Server 2008 Datacenter, Windows Server 2008 Enterprise

Header

ClusAPI.h

Library

ClusAPI.lib

DLL

ClusAPI.dll

See also

Node Management Functions
CreateCluster
PCLUSTER_SETUP_PROGRESS_CALLBACK

 

 

Show: