使用所提供的進程識別碼來設定快照集。
語法
HRESULT ConfigSnapshotByPID
([in, out] ULONG* pids,
[in] ULONG cPids,
[in] VARIANT_BOOL fEnable);
參數
pids
[in]進程識別碼陣列的指標。
cPids
[in]陣列中的進程識別碼數目。
fEnable
[in]布林值，指出是否要啟用或停用快照集。
傳回值
下表描述可能的傳回值。
| 傳回值 | 描述 |
|---|---|
| S_OK | 指定進程的組態成功。 |
| S_FALSE | 設定已部分成功。 請參閱 pResults 以進一步調查哪些進程失敗。 |
| E_WPRC_FAILED_TO_CONFIGURE_HEAP_SNAPSHOT_PIDS | 無法設定 PID () 的堆積堆疊控制項。 |
備註
當函式傳回部分失敗 (S_FALSE) 時，這表示未成功設定進程識別碼陣列中的所有進程。 若要尋找 (失敗的進程) ，請使用 ConfigSnapshotByPIDEx 函式。
快照集組態有效，直到明確停用或進程結束為止。