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.