IStats::QueryStatus-Methode

  • Artikel

Die QueryStatus-Methode ruft die status des NPP ab.

Syntax

HRESULT STDMETHODCALLTYPE QueryStatus(
  [out] NETWORKSTATUS *pNetworkStatus
);

Parameter

pNetworkStatus [out]

Zeiger auf eine zurückgegebene NETWORKSTATUS-Struktur , die den aktuellen Zustand (Erfassung, Angehalten, Beendet usw.) des NPP angibt. Es liegt in der Verantwortung der Anwendung, den Arbeitsspeicher für die NETWORKSTATUS-Struktur zuzuweisen und freizugeben.

Rückgabewert

Wenn die Methode erfolgreich ist, wird der Rückgabewert NMERR_SUCCESS.

Wenn die Methode nicht erfolgreich ist, ist der Rückgabewert der folgende Fehlercode:

Rückgabecode Beschreibung
NMERR_INVALID_PARAMETER
 Der pNetworkStatus-Parameter verweist nicht auf eine gültige NETWORKSTATUS-Struktur . Ordnen Sie Arbeitsspeicher für diese Struktur zu, und rufen Sie die IStats::QueryStatus-Methode erneut auf.

Bemerkungen

Diese Methode kann jederzeit aufgerufen werden, nachdem die CreateNPPInterface-Methode aufgerufen wurde. Er kann aufgerufen werden, um zu ermitteln, ob das NPP mit dem Netzwerk verbunden ist, um die status der aktuellen Erfassung zu ermitteln und zu ermitteln, ob Trigger ausstehen. Bevor Sie diese Methode aufrufen, müssen Sie jedoch den für die NETWORKSTATUS-Struktur erforderlichen Arbeitsspeicher zuordnen und diesen Arbeitsspeicher freigeben, wenn die Struktur nicht mehr benötigt wird.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
 Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
 Windows 2000 Server [nur Desktop-Apps]
Header
Netmon.h
DLL
Ndisnpp.dll;
Rmtnpp.dll

Siehe auch

IStats

CreateNPPInterface

NETWORKSTATUS