Função OpenClusterNetInterfaceEx (clusapi.h)

Abre um identificador para um adaptador de rede.

Sintaxe

HNETINTERFACE OpenClusterNetInterfaceEx(
  [in]            HCLUSTER hCluster,
  [in, optional]  LPCWSTR  lpszInterfaceName,
  [in]            DWORD    dwDesiredAccess,
  [out, optional] DWORD    *lpdwGrantedAccess
);

Parâmetros

[in] hCluster

Manipule para um cluster.

[in, optional] lpszInterfaceName

Ponteiro para uma cadeia de caracteres Unicode terminada em nulo que contém o nome do adaptador de rede 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 OpenClusterNetInterface.

[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, OpenClusterNetInterfaceEx retornará um identificador aberto para o adaptador de rede especificado.

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

CloseClusterNetInterface

Funções de gerenciamento de interface de rede

OpenClusterNetInterface