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

El método GetNetworkConnection recupera una red basada en un identificador de conexión de red proporcionado.

Sintaxis

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

Parámetros

[in] gdNetworkConnectionId

GUID que especifica el identificador de conexión de red.

[out, retval] ppNetworkConnection

Puntero a un puntero al objeto INetworkConnection asociado al gdNetworkConnectionId proporcionado.

Valor devuelto

Devuelve S_OK si el método se ejecuta correctamente. De lo contrario, el método devuelve uno de los valores siguientes.

Comentarios

Este método puede devolver S_FALSE si se ha quitado una conexión de red asociada al identificador especificado. Por ejemplo, es posible que un cliente reciba un evento INetworkConnectionEvents::NetworkConnectionConnectivityChanged junto con un identificador de conexión de red, pero busque que la conexión de red se ha desconectado o incluso reemplazado por la hora en que se llama a INetworkListManager::GetNetworkConnection por el identificador proporcionado.

Requisitos

Consulte también

INetworkConnection

INetworkListManager