Função OpenClusterGroupEx (clusapi.h)

Artigo
02/24/2024

Abre um grupo de clusters de failover e retorna um identificador para ele.

Sintaxe

HGROUP OpenClusterGroupEx(
  [in]            HCLUSTER hCluster,
  [in, optional]  LPCWSTR  lpszGroupName,
  [in]            DWORD    dwDesiredAccess,
  [out, optional] DWORD    *lpdwGrantedAccess
);

Parâmetros

[in] hCluster

Manipule para um cluster que inclui o grupo a ser aberto.

[in, optional] lpszGroupName

Nome do grupo a ser aberto.

[in] dwDesiredAccess

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 OpenClusterGroup.

[out, optional] lpdwGrantedAccess

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, OpenClusterGroupEx retornará um identificador de grupo.

Código de retorno	Descrição
NULL	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 OpenClusterGroupEx (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).

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

Confira também

CloseClusterGroup

Funções de gerenciamento de grupo

OpenClusterGroup

Compartilhar via