Freigeben über

INetworkListManager::GetNetworkConnection-Methode (netlistmgr.h)

  • Artikel

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

Syntax

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

Parameter

[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.

Rückgabewert

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.

Hinweise

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.

Anforderungen

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

Weitere Informationen

INetworkConnection

INetworkListManager