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 |
---|---|
|
La rete associata all'ID di connessione di rete specificato non è stata trovata. |
|
Il puntatore passato è NULL. |
|
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 |