ConfigSnapshotByPIDEx
指定されたプロセス ID を使用してスナップショットを構成します。
構文
HRESULT ConfigSnapshotByPIDEx
([in] SnapshotType snapshotType,
[in, out] ULONG* pids,
[in, out] HRESULT* pResults,
[in] ULONG cPids,
[in] VARIANT_BOOL fEnable);
パラメーター
snapshotType
[in] SnapshotType。
注 : 現使用可能な SnapshotType は SnapshotType_Heap だけです
pids
[in] プロセス ID の配列のポインター。
pResults
[in、out] 2 番目のパラメーターで渡された配列である、指定された各プロセス ID のスナップショット構成 hresult コードを格納する、ユーザーが割り当てたバッファー。
cPids
[in] 配列内のプロセス ID の数。
fEnable
[in] スナップショットを有効にするか無効にするかを示すブール値。
戻り値
返される可能性のある戻り値を次の表に示します。
| 戻り値 | 説明 |
|---|---|
| S_OK | 指定されたプロセスの構成が成功しました。 |
| S_FALSE | 構成が部分的に成功しました。 失敗したプロセスを詳細に調査するには、pResults を参照してください。 |
| E_WPRC_FAILED_TO_CONFIGURE_HEAP_SNAPSHOT_PIDS | PID のヒープ スタック制御を構成できませんでした。 |
注釈
関数が少なくとも部分的なエラー (S_FALSE) を返した場合、pResults の各要素は、2 番目のパラメーターで渡された対応するプロセス ID の構成結果を示します。
たとえば、3 つの pid を渡した場合、pResults 配列は、次に示すように各 pid の構成結果を示します。
| Pids [in] | 0x1086 | 0x98004 | 0x12004 |
| pResults [out] | S_OK | E_INVALIDARG | S_OK |
スナップショットの構成は、明示的に無効化されるか、プロセスが終了するまで有効です。