Freigeben über

SnapshotOnDemand

  • Artikel

Dauert eine Momentaufnahme für den angegebenen SnapshotType für die angegebenen Prozesse, die dann in die Ablaufverfolgungspuffer exportiert werden. Die Momentaufnahme muss vor dem Aufrufen dieser API konfiguriert werden.

Syntax

HRESULT SnapshotOnDemand
([in] SnapshotType snapshotType,
[in] ULONG* pids,
[in] ULONG cPids);

Parameter

snapshotType
[in] SnapshotType.
Hinweis: Derzeit nur SnapshotTypeSnapshotType_Heap.
pids
[in] Der Zeiger auf ein Array von Prozess-IDs. Bis zu 8 Prozess-IDs können angegeben werden.
cPids
[in] Die Anzahl der Prozess-IDs im Array. Maximale Anzahl von 8.

Rückgabewert

In der folgenden Tabelle sind die möglichen Rückgabewerte beschrieben.

Rückgabewert BESCHREIBUNG
S_OK Die Momentaufnahme wird erfolgreich für die angegebenen Prozesse erstellt.
E_WPRC_EXCEEDED_HEAP_SNAPSHOT_PIDS Die Anzahl der PIDs hat den maximal zulässigen Grenzwert überschritten. Bis zu 8 Pids können angegeben werden.