Função CreateCluster (clusapi.h)

Cria e inicia um cluster. O cluster consiste no conjunto de nós especificados, com o Nome da Rede, o Endereço IP e os recursos de quorum , se especificados. O tipo PCLUSAPI_CREATE_CLUSTER define um ponteiro para essa função.

Sintaxe

HCLUSTER CreateCluster(
  [in]           PCREATE_CLUSTER_CONFIG           pConfig,
  [in, optional] PCLUSTER_SETUP_PROGRESS_CALLBACK pfnProgressCallback,
  [in, optional] PVOID                            pvCallbackArg
);

Parâmetros

[in] pConfig

Endereço de uma estrutura CREATE_CLUSTER_CONFIG que contém informações de configuração sobre o cluster a ser criado.

[in, optional] pfnProgressCallback

Endereço da função de retorno de chamada que corresponde ao ponteiro da função PCLUSTER_SETUP_PROGRESS_CALLBACK que será chamado periodicamente para fornecer progresso na criação do cluster.

[in, optional] pvCallbackArg

Argumento para a função de retorno de chamada.

Valor de retorno

Manipule para o cluster ou NULL recém-criado. Um valor não NULL não indica o êxito completo (todos os nós serão adicionados, mas nem todos os recursos de Nome de Rede ou endereço IP podem ter sido criados. Os parâmetros passados para a função apontada pelo parâmetro pfnProgressCallback devem ser verificados.

Código de retorno	Description
NULL	Menos de uma maioria dos nós foi criada com êxito. Para obter mais informações sobre o erro, chame a função GetLastError.

Observações

O tipo PCLUSAPI_CREATE_CLUSTER define um ponteiro para essa função e pode ser usado com a função GetProcAddress para chamar essa função.

Depois que a função CreateCluster for concluída com êxito, pelo menos 30 segundos deverão ser permitidos antes que a função AddClusterNode seja chamada para adicionar nós adicionais.

A função CreateCluster é concluída com êxito após a obtenção do quorum do cluster. Um ou mais nós de cluster podem estar em um estado ClusterNodeDown ou ClusterNodeJoining por alguns segundos.

Antes de chamar a função CreateCluster , a função CoInitializeEx deve ser chamada especificando COINIT_MULTITHREADED e COINIT_DISABLE_OLE1DDE para o parâmetro dwCoInit , conforme mostrado no código a seguir.

CoInitializeEx( NULL, COINIT_MULTITHREADED | COINIT_DISABLE_OLE1DDE );

Requirements

Requirement	Value
Cliente mínimo suportado	Nenhum compatível
Servidor mínimo compatível	Windows Server 2008 Datacenter, Windows Server 2008 Enterprise
da Plataforma de Destino	Windows
Header	clusapi.h
Library	ClusAPI.lib
de DLL	ClusAPI.dll

Consulte também

AddClusterNode

CREATE_CLUSTER_CONFIG

Funções de gerenciamento de cluster

DestroyCluster

PCLUSTER_SETUP_PROGRESS_CALLBACK