IStats::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 (Erfassen, Anhalten, Beendet usw.) des NPP angibt. Es liegt in der Verantwortung der Anwendung, den Arbeitsspeicher für die NETWORKSTATUS-Struktur zuzuordnen und freizugeben.
Rückgabewert
Wenn die Methode erfolgreich ist, lautet der Rückgabewert NMERR _ SUCCESS.
Wenn die Methode nicht erfolgreich ist, ist der Rückgabewert der folgende Fehlercode:
| Rückgabecode | Beschreibung |
|---|---|
|
Der pNetworkStatus-Parameter verweist nicht auf eine gültige NETWORKSTATUS-Struktur. Belegen Sie Arbeitsspeicher für diese Struktur, und rufen Sie die IStats::QueryStatus-Methode erneut auf. |
Bemerkungen
Diese Methode kann jederzeit aufgerufen werden, nachdem die CreateNPPInterface-Methode aufgerufen wurde. Sie kann aufgerufen werden, um festzustellen, ob das NPP mit dem Netzwerk verbunden ist, um den Status der aktuellen Erfassung zu ermitteln und um festzustellen, ob Trigger ausstehend sind. 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.
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 |
|
| DLL |
|