Compartilhar via

Método INetworkListManager::GetNetworkConnection (netlistmgr.h)

  • Artigo

O método GetNetworkConnection recupera uma rede com base em uma ID de Conexão de Rede fornecida.

Sintaxe

HRESULT GetNetworkConnection(
  [in]          GUID               gdNetworkConnectionId,
  [out, retval] INetworkConnection **ppNetworkConnection
);

Parâmetros

[in] gdNetworkConnectionId

Um GUID que especifica a ID de Conexão de Rede.

[out, retval] ppNetworkConnection

Ponteiro para um ponteiro para o objeto INetworkConnection associado ao gdNetworkConnectionId fornecido.

Retornar valor

Retornará S_OK se o método for bem-sucedido. Caso contrário, o método retornará um dos valores a seguir.

Código de retorno Descrição
S_FALSE
 A rede associada à ID de conexão de rede especificada não foi encontrada.
E_POINTER
 O ponteiro passado é NULL.
E_UNEXPECTED
 O GUID especificado é inválido.

Comentários

Esse método poderá retornar S_FALSE se uma conexão de rede associada à ID especificada tiver sido removida. Por exemplo, é possível que um cliente receba um evento INetworkConnectionEvents::NetworkConnectionConnectivityChanged junto com uma ID de conexão de rede, mas descubra que a conexão de rede foi desconectada ou até mesmo substituída pela hora em que INetworkListManager::GetNetworkConnection é chamada com a ID fornecida.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho netlistmgr.h

Confira também

INetworkConnection

INetworkListManager