Função OpenClusterNetworkEx (clusapi.h)
Abre uma conexão com uma rede e retorna um identificador para ela.
Sintaxe
HNETWORK OpenClusterNetworkEx(
[in] HCLUSTER hCluster,
[in, optional] LPCWSTR lpszNetworkName,
[in] DWORD dwDesiredAccess,
[out, optional] DWORD *lpdwGrantedAccess
);
Parâmetros
[in] hCluster
Manipule para um cluster.
[in, optional] lpszNetworkName
Ponteiro para o nome de uma rede existente.
[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 OpenClusterNetwork.
[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, OpenClusterNetworkEx retornará um identificador de rede.
| 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 OpenClusterNetworkEx (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 |