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