Compartilhar via

Função OpenCluster (clusapi.h)

  • Artigo

Abre uma conexão com um cluster e retorna um identificador para ele.

Sintaxe

HCLUSTER OpenCluster(
  [in, optional] LPCWSTR lpszClusterName
);

Parâmetros

[in, optional] lpszClusterName

Especifica um dos seguintes valores:

  • Ponteiro para uma cadeia de caracteres Unicode terminada em nulo que contém o nome do cluster ou um dos nós de cluster expressos como um nome NetBIOS, um nome DNS totalmente qualificado ou um endereço IP. Isso produz um identificador de cluster RPC.
  • NULL, que produz um identificador LPC para o cluster ao qual o computador local pertence.

Retornar valor

Se a operação tiver sido bem-sucedida, OpenCluster retornará um identificador de cluster.

Valor/código retornado Descrição
NULL
0
 A operação não foi bem-sucedida. Para obter mais informações sobre o erro, chame a função GetLastError.

Comentários

Um identificador de cluster é um ponteiro para uma estrutura definida internamente que armazena informações sobre a conexão RPC ou LPC com o cluster. Todos os identificadores de objeto obtidos do identificador de cluster serão associados aos dados de sessão RPC ou LPC armazenados na estrutura do cluster. Combinar identificadores RPC e LPC ou usar identificadores obtidos de contextos diferentes pode causar exceções ou outros resultados imprevisíveis. Para obter mais informações, consulte Identificadores LPC e RPC.

Quando terminar com um identificador de cluster, é importante chamar CloseCluster para garantir que toda a memória seja liberada e que a conexão seja desligada corretamente.

Se o cluster for remoto, o cliente deverá estar executando um sistema operacional compatível. Por exemplo, os computadores que executam o Windows Server 2008 não podem chamar OpenCluster em um cluster que executa Windows Server 2016. Para gerenciar remotamente esses clusters, use o Provedor WMI de Cluster de Failover.

Exemplos

Consulte Usando identificadores de objeto.

Requisitos

Requisito Valor
Cliente mínimo com suporte Nenhum compatível
Servidor mínimo com suporte Windows Server 2008 Enterprise, Windows Server 2008 Datacenter
Plataforma de Destino Windows
Cabeçalho clusapi.h
Biblioteca ClusAPI.lib
DLL ClusAPI.dll

Confira também

CloseCluster

Funções de gerenciamento de cluster de failover

OpenClusterEx