NPGetConnectionPerformance-Funktion (npapi.h)

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 verwendet werden, die derzeit verbunden ist.

Syntax

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

Die Parameter

[in] lpRemoteName

Zeigen Sie auf den lokalen Namen oder den 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 cbStructure-Felds , werden mit Nullen gefüllt, bevor die MPR die Anforderung an die Netzwerkanbieter übergibt. Daher muss der Anbieter nur in Felder schreiben, für die er Informationen zur Verfügung hat. Für Zinswerte bedeutet ein Wert von 1, 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 dwFlags-Feld entsprechend festlegen.

Rückgabewert

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

Anforderungen