Compartilhar via

Função OpenClusterEx (clusapi.h)

  • Artigo

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

Sintaxe

HCLUSTER OpenClusterEx(
  [in, optional]  LPCWSTR lpszClusterName,
  [in]            DWORD   DesiredAccess,
  [out, optional] DWORD   *GrantedAccess
);

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.

[in] DesiredAccess

Os privilégios de acesso solicitados. Pode ser qualquer combinação de GENERIC_READ (0x80000000), GENERIC_ALL (0x10000000) ou MAXIMUM_ALLOWED (0x02000000). Se esse valor for zero (0) e um erro indefinido puder ser retornado. Usar GENERIC_ALL é o mesmo que chamar OpenCluster.

[out, optional] GrantedAccess

Parâmetro opcional que contém o endereço de um DWORD que receberá os direitos de acesso concedidos. Se o parâmetro DesiredAccess for MAXIMUM_ALLOWED (0x02000000), o DWORD apontado por esse parâmetro conterá os privilégios máximos concedidos a esse usuário.

Retornar valor

Se a operação tiver sido bem-sucedida, OpenClusterEx 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 . Se o servidor de destino não der suporte à função OpenClusterEx (por exemplo, se o servidor de destino estiver executando o Windows Server 2008 ou anterior), a função GetLastError retornará RPC_S_PROCNUM_OUT_OF_RANGE (1745).

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.

Requisitos

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