ConfigSnapshotByPID
Konfiguriert Momentaufnahme mithilfe der angegebenen Prozess-ID.
Syntax
HRESULT ConfigSnapshotByPID
([in, out] ULONG* pids,
[in] ULONG cPids,
[in] VARIANT_BOOL fEnable);
Parameter
pids
[in] Der Zeiger auf ein Array von Prozess-IDs.
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 einen Teilfehler (S_FALSE) zurückgibt, bedeutet dies, dass nicht alle Prozesse im Prozess-ID-Array erfolgreich konfiguriert sind. Verwenden Sie die ConfigSnapshotByPIDEx-Funktion, um zu ermitteln, welche(r) Prozesse fehlgeschlagen sind.
Die Momentaufnahmekonfiguration ist gültig, bis sie explizit deaktiviert oder der Prozess beendet wird.