MultinetGetConnectionPerformanceW-Funktion (winnetwk.h)
Die MultinetGetConnectionPerformance-Funktion gibt Informationen über die erwartete Leistung einer Verbindung zurück, die für den Zugriff auf eine Netzwerkressource verwendet wird.
Syntax
DWORD MultinetGetConnectionPerformanceW(
[in] LPNETRESOURCEW lpNetResource,
[out] LPNETCONNECTINFOSTRUCT lpNetConnectInfoStruct
);
Parameter
[in] lpNetResource
Ein Zeiger auf eine NETRESOURCE-Struktur , die die Netzwerkressource angibt. Die folgenden Member haben in diesem Kontext eine bestimmte Bedeutung.
[out] lpNetConnectInfoStruct
Ein Zeiger auf die NETCONNECTINFOSTRUCT-Struktur , die die Daten empfängt.
Rückgabewert
Wenn die Funktion erfolgreich ist, wird der Rückgabewert NO_ERROR.
Wenn die Funktion fehlschlägt, ist der Rückgabewert ein Systemfehlercode, z. B. einer der folgenden Werte.
Rückgabecode | Beschreibung |
---|---|
|
Die Netzwerkressource stellt diese Informationen nicht zur Verfügung. |
|
Der lpLocalName-Member der NETRESOURCE-Struktur , auf die der lpNetResource-Parameter verweist, gibt kein umgeleitetes Gerät an, oder das lpRemoteName-Element gibt nicht den Namen einer Ressource an, die derzeit verbunden ist. |
|
Der Vorgang konnte nicht abgeschlossen werden, weil eine Netzwerkkomponente nicht gestartet wurde oder weil der angegebene Ressourcenname nicht erkannt wird. |
|
Das vom lpLocalName-Member angegebene lokale Gerät ist ungültig. |
|
„Der Netzwerkname wurde nicht gefunden.“ Dieser Fehler wird zurückgegeben, wenn der lpLocalName-Member der NETRESOURCE-Struktur , auf die der parameter lpNetResource verweist, NULL war und das lpRemoteName-Element der NETRESOURCE-Struktur , auf die von lpNetResource verwiesen wird, ebenfalls oder NULL war oder von keinem Netzwerk erkannt werden konnte. |
|
Ein Versuch, auf eine ungültige Adresse zuzugreifen. Dieser Fehler wird zurückgegeben, wenn die Parameter lpNetResource oder lpNetConnectInfoStructNULL sind. |
|
Ein ungültiger Parameter wurde übergeben. Dieser Fehler wird zurückgegeben, wenn der lpNetConnectInfoStruct-Parameter nicht auf eine NETCONNECTINFOSTRUCT-Struktur verweist, in der das cbStructure-Element mit der richtigen Strukturgröße gefüllt ist. |
|
Das Netzwerk ist nicht verfügbar. |
|
Ein netzwerkspezifischer Fehler ist aufgetreten. Rufen Sie WNetGetLastError auf, um eine Beschreibung des Fehlers zu erhalten. |
Hinweise
Die MultinetGetConnectionPerformance-Funktion gibt die Informationen in einer NETCONNECTINFOSTRUCT-Struktur zurück.
Die von der MultinetGetConnectionPerformance-Funktion zurückgegebenen Informationen sind nur eine Schätzung. Netzwerkdatenverkehr und Routing können sich auf die Genauigkeit der zurückgegebenen Ergebnisse auswirken.
Beachten Sie, dass die MultinetGetConnectionPerformance-Funktion nur verwendet werden kann, um Informationen für ein lokales Gerät anzufordern, das an eine Netzwerkressource umgeleitet wird, oder für eine Netzwerkressource, mit der derzeit eine Verbindung besteht.
Wenn ein UNC-Pfad im lpRemoteName-Member der NETRESOURCE-Struktur angegeben wird, auf die der lpNetResource-Parameter verweist, muss das lpRemoteName-Element ein Verzeichnisname und kein Dateiname sein.
Eine typische Möglichkeit, diese Funktion zu verwenden, besteht darin, eine Datei auf einem Netzwerkserver zu öffnen (wodurch sichergestellt wird, dass eine Verbindung mit der Datei besteht), diese Funktion aufzurufen und die Ergebnisse zu verwenden, um Entscheidungen über die Verwaltung der Datei-E/A zu treffen. Beispielsweise können Sie entscheiden, ob die gesamte Datei in eine temporäre Datei auf dem Client gelesen oder direkt auf die Datei auf dem Server zugegriffen werden soll.
Hinweis
Der winnetwk.h-Header definiert MultinetGetConnectionPerformance als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
Zielplattform | Windows |
Kopfzeile | winnetwk.h |
Bibliothek | Mpr.lib |
DLL | Mpr.dll |