Compartir a través de

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

  • Artículo

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.

Código devuelto Descripción
S_FALSE
 No se encontró la red asociada al identificador de conexión de red especificado.
E_POINTER
 El puntero pasado es NULL.
E_UNEXPECTED
 El GUID especificado no es válido.

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

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado netlistmgr.h

Consulte también

INetworkConnection

INetworkListManager