Função OpenClusterResourceEx (clusapi.h)

Artigo
08/22/2023

Abre um recurso e retorna um identificador para ele.

Sintaxe

HRESOURCE OpenClusterResourceEx(
  [in]            HCLUSTER hCluster,
  [in, optional]  LPCWSTR  lpszResourceName,
  [in]            DWORD    dwDesiredAccess,
  [out, optional] DWORD    *lpdwGrantedAccess
);

Parâmetros

[in] hCluster

Manipule para um cluster.

[in, optional] lpszResourceName

Ponteiro para uma cadeia de caracteres Unicode terminada em nulo que contém o nome do recurso a ser aberto.

Os nomes de recursos não diferenciam maiúsculas de minúsculas. Um nome de recurso deve ser exclusivo dentro do cluster. O nome é definido quando o recurso é criado e pode ser alterado usando a função SetClusterResourceName .

[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 OpenClusterResource.

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

Valor retornado

Se a operação tiver sido bem-sucedida, OpenClusterResourceEx retornará um identificador para o recurso aberto.

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 OpenClusterResourceEx (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


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

CloseClusterResource

Funções de gerenciamento de recursos de cluster de failover

OpenClusterResource

Compartilhar via