CREATE_CLUSTER_CONFIG structure

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;
} 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.

Requirements

Minimum supported client

None supported

Minimum supported server

Windows Server 2008 Datacenter, Windows Server 2008 Enterprise

Header

ClusAPI.h

See also

Utility structures
CreateCluster
CLUSTER_IP_ENTRY

 

 

Show: