IRTC::QueryStatus-Methode

Die QueryStatus-Methode ruft den 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 des NPP angibt (Erfassen, Anhalten, Beendeten und so weiter). Es liegt in der Verantwortung der Anwendung, den Arbeitsspeicher für die NETWORKSTATUS-Struktur zu reservieren und frei zu geben.

Rückgabewert

Wenn die Methode erfolgreich ist, ist 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 zeigt nicht auf eine gültige NETWORKSTATUS-Struktur. Ordnen Sie Arbeitsspeicher für diese Struktur zu, und rufen Sie IRTC::QueryStatus erneut auf.

Bemerkungen

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

Requirements (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

Weitere Informationen

IRTC

CreateNPPInterface

NETWORKSTATUS