NPGetConnectionPerformance-Funktion (npapi.h)

Artikel
08/25/2023

Gibt Informationen zur erwarteten Leistung einer Verbindung zurück, die für den Zugriff auf eine Netzwerkressource verwendet wird. Die Anforderung kann nur für eine Netzwerkressource erfolgen, die derzeit verbunden ist.

Syntax

DWORD NPGetConnectionPerformance(
  [in]  LPCWSTR                lpRemoteName,
  [out] LPNETCONNECTINFOSTRUCT lpNetConnectInfo
);

Parameter

[in] lpRemoteName

Zeiger auf den lokalen Namen oder Remotenamen für eine verbundene Ressource.

[out] lpNetConnectInfo

Zeiger auf eine NETCONNECTINFOSTRUCT-Struktur , die vom Netzwerkanbieter ausgefüllt wird, wenn der Anbieter über eine Verbindung mit der Netzwerkressource verfügt. Alle anderen Felder dieser Struktur mit Ausnahme des Felds cbStructure werden mit Nullen gefüllt, bevor der MPR die Anforderung an die Netzwerkanbieter weitergibt. Daher muss der Anbieter nur in Felder schreiben, für die Informationen verfügbar sind. Außerdem bedeutet ein Wert von 1 für Ratenwerte, dass die Leistung besser ist, als in der Einheit dargestellt werden kann.

Die zurückgegebenen Informationen können eine Schätzung sein. Wenn das Netzwerk keine Informationen über die Ressource im Netzwerk abrufen kann, kann es Informationen über den Netzwerkadapter und die zugehörige Leistung zurückgeben und dann das Feld dwFlags entsprechend festlegen.

Rückgabewert

Wenn die Funktion erfolgreich ist, sollte sie WN_SUCCESS zurückgeben. Andernfalls sollte ein Fehlercode zurückgegeben werden, der einer der folgenden sein kann.

Rückgabecode	Beschreibung
WN_NOT_CONNECTED	lpRemoteName ist keine verbundene Netzwerkressource.
WN_NO_NETWORK	Das Netzwerk ist nicht vorhanden.

Anforderungen


Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	npapi.h

Freigeben über