ConfigSnapshotByPID

指定されたプロセス ID を使用してスナップショットを構成します。

構文

HRESULT ConfigSnapshotByPID
([in, out] ULONG* pids,
 [in] ULONG cPids,
[in] VARIANT_BOOL fEnable);

pids
[in] プロセス ID の配列へのポインター。
cPids
[in] 配列内のプロセス ID の数。
fEnable
[in] スナップショットを有効にするか無効にするかを示すブール値。

返される可能性のある戻り値を次の表に示します。

戻り値	説明
S_OK	指定されたプロセスの構成が成功しました。
S_FALSE	構成が部分的に成功しました。失敗したプロセスを詳細に調査するには、pResults を参照してください。
E_WPRC_FAILED_TO_CONFIGURE_HEAP_SNAPSHOT_PIDS	PID のヒープスタック制御を構成できませんでした。

関数から部分的なエラー (S_FALSE) が返された場合、これはプロセス ID 配列内の一部のプロセスが正常に構成されていないことを意味します。失敗したプロセスを見つけるには、ConfigSnapshotByPIDEx 関数を使用します。

スナップショットの構成は、それが明示的に無効化されるか、プロセスが終了するまで有効です。