PssWalkSnapshot-Funktion (processsnapshot.h)

Artikel
08/25/2023

Gibt Informationen von der aktuellen Schrittposition zurück und erweitert die Schrittmarkierung zur nächsten Position.

Syntax

DWORD PssWalkSnapshot(
  [in]  HPSS                       SnapshotHandle,
  [in]  PSS_WALK_INFORMATION_CLASS InformationClass,
  [in]  HPSSWALK                   WalkMarkerHandle,
  [out] void                       *Buffer,
  [in]  DWORD                      BufferLength
);

Parameter

[in] SnapshotHandle

Ein Handle für die Momentaufnahme.

[in] InformationClass

Der Typ der zurückzugebenden Informationen. Weitere Informationen finden Sie unter PSS_WALK_INFORMATION_CLASS.

[in] WalkMarkerHandle

Ein Handle für eine Schrittmarkierung. Die Schrittmarkierung gibt die Schrittposition an, von der Daten zurückgegeben werden sollen. PssWalkSnapshot verschiebt die Schrittmarkierung zur nächsten Schrittposition in der Zeitreihenfolge, bevor er zum Aufrufer zurückkehrt.

[out] Buffer

Die Momentaufnahme Informationen, die diese Funktion zurückgibt.

[in] BufferLength

Die Größe des Puffers in Bytes.

Rückgabewert

Diese Funktion gibt ERROR_SUCCESS bei Erfolg oder einen der folgenden Fehlercodes zurück.

Rückgabecode	Beschreibung
ERROR_BAD_LENGTH	Die angegebene Pufferlänge ist ungültig.
ERROR_INVALID_HANDLE	Das angegebene Handle ist ungültig.
ERROR_INVALID_PARAMETER	Die angegebene Informationsklasse ist ungültig.
ERROR_MORE_DATA	Der Puffer ist NULL, und es gibt Daten an der aktuellen Position, die zurückgegeben werden sollen.
ERROR_NO_MORE_ITEMS	Der Spaziergang wurde abgeschlossen, und es gibt keine weiteren Elemente, die zurückgegeben werden müssen.
ERROR_NOT_FOUND	Die angeforderten Informationen sind nicht im Momentaufnahme.

Alle Fehlercodes sind in winerror.h definiert. Verwenden Sie FormatMessage mit dem flag FORMAT_MESSAGE_FROM_SYSTEM , um eine Meldung für einen Fehlercode abzurufen.

Hinweise

Für Momentaufnahme Datentypen, die eine variable Anzahl von Instanzen innerhalb eines Momentaufnahme haben, verwenden Sie die PssWalkSnapshot-Funktion, um die Instanzen nacheinander abzurufen. Sie legen den Parameter InformationClass fest, um den Datentyp anzugeben.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8.1 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	processsnapshot.h
DLL	Kernel32.dll

Siehe auch

Prozessmomentaufnahme

Freigeben über