Função OpenClusterNodeEx (clusapi.h)

Abre um nó e retorna um identificador para ele.

Sintaxe

HNODE OpenClusterNodeEx(
  [in]            HCLUSTER hCluster,
  [in, optional]  LPCWSTR  lpszNodeName,
  [in]            DWORD    dwDesiredAccess,
  [out, optional] DWORD    *lpdwGrantedAccess
);

Parâmetros

[in] hCluster

Manipule para um cluster retornado das funções OpenCluster ou OpenClusterEx .

[in, optional] lpszNodeName

Ponteiro para o nome NetBIOS de um nó existente. Se o nome DNS do nó for usado, a função OpenClusterNodeEx falhará e GetLastError retornará ERROR_CLUSTER_NODE_NOT_FOUND.

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

[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, OpenClusterNodeEx retornará um identificador de nó.

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

CloseClusterNode

Funções de gerenciamento de nó

OpenCluster

OpenClusterEx

OpenClusterNode