Metodo INetworkListManager::GetNetworkConnection (netlistmgr.h)

Il metodo GetNetworkConnection recupera una rete in base a un ID connessione di rete fornito.

Sintassi

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

Parametri

[in] gdNetworkConnectionId

GUID che specifica l'ID connessione di rete.

[out, retval] ppNetworkConnection

Puntatore a un puntatore all'oggetto INetworkConnection associato all'oggetto gdNetworkConnectionId fornito.

Valore restituito

Restituisce S_OK se il metodo ha esito positivo. In caso contrario, il metodo restituisce uno dei valori seguenti.

Codice restituito Descrizione
S_FALSE
La rete associata all'ID di connessione di rete specificato non è stata trovata.
E_POINTER
Il puntatore passato è NULL.
E_UNEXPECTED
Il GUID specificato non è valido.

Commenti

Questo metodo può restituire S_FALSE se è stata rimossa una connessione di rete associata all'ID specificato. Ad esempio, è possibile che un client riceva un evento INetworkConnectionEvents::NetworkConnectionConnectivityChanged insieme a un ID connessione di rete, ma trovare che la connessione di rete sia stata disconnessa o anche sostituita dall'ora in cui INetworkListManager::GetNetworkConnection viene chiamata con l'ID specificato.

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2008 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione netlistmgr.h

Vedi anche

INetworkConnection

INetworkListManager