INetworkListManager::GetNetworkConnection-Methode (netlistmgr.h)

Die GetNetworkConnection-Methode ruft ein Netzwerk basierend auf einer angegebenen Netzwerkverbindungs-ID ab.

Syntax

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

[in] gdNetworkConnectionId

Eine GUID , die die Netzwerkverbindungs-ID angibt.

[out, retval] ppNetworkConnection

Zeiger auf einen Zeiger auf das INetworkConnection-Objekt , das der angegebenen gdNetworkConnectionId zugeordnet ist.

Gibt S_OK zurück, wenn die Methode erfolgreich war. Andernfalls gibt die Methode einen der folgenden Werte zurück.

Rückgabecode	Beschreibung
S_FALSE	Das netzwerk, das der angegebenen Netzwerkverbindungs-ID zugeordnet ist, wurde nicht gefunden.
E_POINTER	Der übergebene Zeiger ist NULL.
E_UNEXPECTED	Die angegebene GUID ist ungültig.

Diese Methode kann S_FALSE zurückgeben, wenn eine der angegebenen ID zugeordnete Netzwerkverbindung entfernt wurde. Beispielsweise ist es möglich, dass ein Client ein INetworkConnectionEvents::NetworkConnectionConnectivityChanged-Ereignis zusammen mit einer Netzwerkverbindungs-ID empfängt , aber feststellen, dass die Netzwerkverbindung getrennt oder sogar durch den Aufruf von INetworkListManager::GetNetworkConnection mit der angegebenen ID ersetzt wurde.

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	netlistmgr.h