Freigeben über

ConfigSnapshotByPIDEx

Konfiguriert eine Momentaufnahme mithilfe der angegebenen Prozess-ID

Syntax

HRESULT ConfigSnapshotByPIDEx
([in] SnapshotType snapshotType,
[in, out] ULONG* pids,
[in, out] HRESULT* pResults,
[in] ULONG cPids,
[in] VARIANT_BOOL fEnable);

Parameter

snapshotType
[in] SnapshotType
Hinweis: Der einzige derzeit verfügbar SnapshotType-Wert ist SnapshotType_Heap.
pids
[in] Der Zeiger auf ein Array von Prozess-IDs
pResults
[in, out] Der von dem oder der Benutzer*in zugewiesene Puffer, der den hresult-Code für die Momentaufnahmekonfiguration für jede angegebene Prozess-ID enthält, die das Array im zweiten Parameter übergeben hat
cPids
[in] Die Anzahl der Prozess-IDs im Array.
fEnable
[in] Ein boolescher Wert, der angibt, ob der Snapshot aktiviert oder deaktiviert werden soll.

Rückgabewert

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

Rückgabewert BESCHREIBUNG
S_OK Die Konfiguration war für die angegebenen Prozesse erfolgreich.
S_FALSE Die Konfiguration war teilweise erfolgreich. Verweisen Sie auf pResults, um weiter zu untersuchen, welcher Prozess fehlgeschlagen ist.
E_WPRC_FAILED_TO_CONFIGURE_HEAP_SNAPSHOT_PIDS Fehler beim Konfigurieren des Heapstapel-Steuerelements von PID(s)

Bemerkungen

Wenn die Funktion zumindest einen Teilfehlschlagen (S_FALSE) zurückgibt, zeigt jedes Element von pResults das Konfigurationsergebnis der entsprechenden Prozess-ID an, die im zweiten Parameter übergeben wurde.

Wenn Sie beispielsweise 3 Pids übergeben, zeigt das pResults-Array, wie unten dargestellt, das Konfigurationsergebnis eines jeden Pid an.

       
Pids [in] 0x1086 0x98004 0x12004
pResults [out] S_OK E_INVALIDARG S_OK

Die Momentaufnahmekonfiguration ist gültig, bis sie explizit deaktiviert oder der Prozess beendet wird.