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.
Retornar valor
Manipule para o cluster recém-criado ou NULL. Um valor não NULL não indica êxito total (todos os nós terão sido adicionados, mas nem todos os recursos de Endereço IP ou Nome de Rede podem ter sido criados. Os parâmetros passados para a função apontada pelo parâmetro pfnProgressCallback devem ser verificados.
| Código de retorno | Descrição |
|---|---|
|
Menos de uma maioria de nós foi criada com êxito. Para obter mais informações sobre o erro, chame a função GetLastError. |
Comentários
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 );
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Nenhum compatível |
| Servidor mínimo com suporte | Windows Server 2008 Datacenter, Windows Server 2008 Enterprise |
| Plataforma de Destino | Windows |
| Cabeçalho | clusapi.h |
| Biblioteca | ClusAPI.lib |
| DLL | ClusAPI.dll |