Freigeben über

NPGetConnectionPerformance-Funktion (npapi.h)

  • Artikel

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