Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 |
|---|---|
|
Das netzwerk, das der angegebenen Netzwerkverbindungs-ID zugeordnet ist, wurde nicht gefunden. |
|
Der übergebene Zeiger ist NULL. |
|
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 |