Freigeben über

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.