MultinetGetConnectionPerformanceA-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 MultinetGetConnectionPerformanceA(
  [in]  LPNETRESOURCEA         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.

Mitglied	Bedeutung
lpLocalName	Ein Zeiger auf einen Puffer, der ein lokales Gerät angibt, z. B. "F:" oder "LPT1", das an eine abzufragte Netzwerkressource umgeleitet wird. Wenn dieser Member NULL oder eine leere Zeichenfolge ist, wird die Netzwerkressource im lpRemoteName-Element angegeben. Wenn dieses Flag ein lokales Gerät angibt, wird lpRemoteName ignoriert.
lpRemoteName	Ein Zeiger auf eine abzufragende Netzwerkressource. Die Ressource muss derzeit über eine verbindung verfügen. Wenn es sich bei der Ressource z. B. um eine Datei auf einem Dateiserver handelt, stellt das Öffnen der Datei die Verbindung sicher.
lpProvider	In der Regel auf NULL festgelegt, kann jedoch ein Zeiger auf den Besitzer (Anbieter) der Ressource sein, wenn das Netzwerk bekannt ist, in dem sich die Ressource befindet. Wenn der lpProvider-Member nicht NULL ist, versucht das System, nur Informationen über das benannte Netzwerk zurückzugeben.

[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
ERROR_NOT_SUPPORTED	Die Netzwerkressource stellt diese Informationen nicht zur Verfügung.
ERROR_NOT_CONNECTED	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.
ERROR_NO_NET_OR_BAD_PATH	Der Vorgang konnte nicht abgeschlossen werden, weil eine Netzwerkkomponente nicht gestartet wurde oder weil der angegebene Ressourcenname nicht erkannt wird.
ERROR_BAD_DEVICE	Das vom lpLocalName-Member angegebene lokale Gerät ist ungültig.
ERROR_BAD_NET_NAME	„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.
ERROR_INVALID_ADDRESS	Ein Versuch, auf eine ungültige Adresse zuzugreifen. Dieser Fehler wird zurückgegeben, wenn die Parameter lpNetResource oder lpNetConnectInfoStructNULL sind.
ERROR_INVALID_PARAMETER	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.
ERROR_NO_NETWORK	Das Netzwerk ist nicht verfügbar.
ERROR_EXTENDED_ERROR	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

Weitere Informationen

NETCONNECTINFOSTRUCT

NETRESOURCE

Übersicht über Windows-Netzwerke (WNet)

Windows-Netzwerkfunktionen