CREATE_CLUSTER_CONFIG structure (clusapi.h)

Defines the initial cluster configuration. This structure is passed in the pConfig parameter to the CreateCluster function.

Syntax

typedef struct _CREATE_CLUSTER_CONFIG {
  DWORD                      dwVersion;
  PCWSTR                     lpszClusterName;
  DWORD                      cNodes;
  PCWSTR                     *ppszNodeNames;
  DWORD                      cIpEntries;
  PCLUSTER_IP_ENTRY          pIpEntries;
  BOOLEAN                    fEmptyCluster;
  CLUSTER_MGMT_POINT_TYPE    managementPointType;
  CLUSTER_MGMT_POINT_RESTYPE managementPointResType;
  PCWSTR                     pszUserName;
  PCWSTR                     pszPassword;
  PCWSTR                     pszDomain;
} CREATE_CLUSTER_CONFIG, *PCREATE_CLUSTER_CONFIG;

Members

dwVersion

Version. Set this to CLUSAPI_VERSION.

lpszClusterName

Name of the cluster.

cNodes

Count of nodes in the array pointed to by the ppszNodeNames member.

ppszNodeNames

Address of array of pointers to strings, each naming a node to be added to the new cluster.

cIpEntries

Count of nodes in the array pointed to by the pIpEntries member. If zero (0), no IP Address or Network Name resources will be created.

pIpEntries

Address of array of pointers to CLUSTER_IP_ENTRY structures, each naming a node to be added to the new cluster. Each entry will be used to configure a separate IP Address resource, and a Network Name resource will be created which depends on all of these IP Address resources in a logical OR manner.

fEmptyCluster

If TRUE, then the cluster is to be created without any nodes and the cIpEntries member must be zero (0) and the pIpEntries member must be NULL.

If FALSE, then the cluster is to be created with at least one node and the cIpEntries member must be one (1) or more, the pIpEntries member must not be NULL, the cNodes member must be one (1) or more, the ppszNodeNames member must not be NULL, and the lpszClusterName member must not be NULL.

managementPointType

A CLUSTER_MGMT_POINT_TYPE value that specifies the management point type. If the value of the fEmptyCluster member of this structure is TRUE, this member is ignored and the structure is treated as if this member were set to CLUSTER_MGMT_POINT_TYPE_NONE. If the dwVersion member of this structure is set to a value less than CLUSAPI_VERSION_WINDOWSBLUE, the value of this member is ignored and the structure is treated as if this member were set to CLUSTER_MGMT_POINT_TYPE_CNO.

Windows Server 2012, Windows Server 2008 R2 and Windows Server 2008:  This member is not supported before Windows Server 2012 R2.

managementPointResType

pszUserName

pszPassword

pszDomain

Requirements

Requirement	Value
Minimum supported client	None supported
Minimum supported server	Windows Server 2008 Datacenter, Windows Server 2008 Enterprise
Header	clusapi.h

See also

CLUSTER_IP_ENTRY

CreateCluster

Utility structures