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

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.

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

Confira também

INetworkConnection

INetworkListManager