MultinetGetConnectionPerformanceA-Funktion (winnetwk.h)

Artikel
11/20/2024

Die MultinetGetConnectionPerformance Funktion gibt Informationen zur erwarteten 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 Mitglieder haben in diesem Zusammenhang spezifische Bedeutungen.

Mitglied	Bedeutung
lpLocalName	Ein Zeiger auf einen Puffer, der ein lokales Gerät angibt, z. B. "F:" oder "LPT1", das an eine Netzwerkressource umgeleitet wird, die abgefragt werden soll. Wenn dieses Element NULL- oder eine leere Zeichenfolge ist, wird die Netzwerkressource im lpRemoteName Member angegeben. Wenn dieses Flag ein lokales Gerät angibt, wird lpRemoteName- ignoriert.
lpRemoteName	Ein Zeiger auf eine Netzwerkressource zum Abfragen. Die Ressource muss derzeit über eine hergestellte Verbindung verfügen. Wenn es sich bei der Ressource beispielsweise um eine Datei auf einem Dateiserver handelt, wird durch öffnen der Datei die Verbindung sichergestellt.
lpProvider-	In der Regel auf NULL-festgelegt, kann jedoch ein Zeiger auf den Besitzer (Anbieter) der Ressource sein, wenn das Netzwerk, in dem sich die Ressource befindet, bekannt ist. Wenn der lpProvider Member nicht NULL-ist, versucht das System, Informationen nur ü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	Diese Informationen werden von der Netzwerkressource nicht bereitgestellt.
ERROR_NOT_CONNECTED	Das lpLocalName- Mitglied der NETRESOURCE- Struktur, auf die durch den parameter lpNetResource verwiesen wird, gibt kein umgeleitetes Gerät an, oder der lpRemoteName Member gibt nicht den Namen einer Ressource an, die derzeit verbunden ist.
ERROR_NO_NET_OR_BAD_PATH	Der Vorgang konnte nicht abgeschlossen werden, entweder weil eine Netzwerkkomponente nicht gestartet wird 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 durch den parameter lpNetResource verwiesen wurde, NULL- und die lpRemoteName Mitglied der NETRESOURCE- Struktur, auf die die lpNetResource- verweist, war ebenfalls oder NULL- oder konnte von keinem Netzwerk erkannt werden.
ERROR_INVALID_ADDRESS	Ein Versuch, auf eine ungültige Adresse zuzugreifen. Dieser Fehler wird zurückgegeben, wenn die parameter lpNetResource oder lpNetConnectInfoStructNULLwurden.
ERROR_INVALID_PARAMETER	Ein ungültiger Parameter wurde übergeben. Dieser Fehler wird zurückgegeben, wenn der parameter lpNetConnectInfoStruct nicht auf eine NETCONNECTINFOSTRUCT Struktur verweist, in der das cbStructure Member mit der richtigen Strukturgröße gefüllt ist.
ERROR_NO_NETWORK	Das Netzwerk ist nicht verfügbar.
ERROR_EXTENDED_ERROR	Es ist ein netzwerkspezifischer Fehler aufgetreten. Rufen Sie WNetGetLastErrorauf, um eine Beschreibung des Fehlers abzurufen.

Bemerkungen

Die funktion MultinetGetConnectionPerformance 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 funktion MultinetGetConnectionPerformance 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 Mitglied der NETRESOURCE- Struktur angegeben wird, auf die durch den parameter lpNetResource verwiesen wird, muss das lpRemoteName Member ein Verzeichnisname sein, kein Dateiname.

Eine typische Möglichkeit, diese Funktion zu verwenden, wäre das Öffnen einer Datei auf einem Netzwerkserver (die sicherstellen würde, dass eine Verbindung mit der Datei besteht), diese Funktion aufrufen und die Ergebnisse verwenden, um Entscheidungen zur Verwaltung von Datei-E/A zu treffen. Sie können z. B. 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.

Anmerkung

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

Anforderung	Wert
mindestens unterstützte Client-	Windows 2000 Professional [nur Desktop-Apps]
mindestens unterstützte Server-	Windows 2000 Server [nur Desktop-Apps]
Zielplattform-	Fenster
Header-	winnetwk.h
Library	Mpr.lib
DLL-	Mpr.dll

Siehe auch

NETCONNECTINFOSTRUCT-

NETRESOURCE-

übersicht über Windows Networking (WNet)

Windows-Netzwerkfunktionen

Freigeben über