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] 用户分配的缓冲区，其中将包含每个指定进程 ID（传入第二个参数的数组）的快照配置 hresult 代码。
cPids
[in] 数组中的进程 ID 数。
fEnable
[in] 一个布尔值，指示是启用还是禁用快照。
返回值
下表描述了可能的返回值。
| 返回值 | 说明 |
|---|---|
| S_OK | 指定的进程配置成功。 |
| S_FALSE | 配置部分成功。 请参阅 pResults 以进一步调查哪个进程失败。 |
| E_WPRC_FAILED_TO_CONFIGURE_HEAP_SNAPSHOT_PIDS | 无法配置 PID 的堆堆栈控制。 |
注解
当函数返回至少部分失败 (S_FALSE) 时，pResults 的每个元素显示传入第二个参数中的对应进程 ID 的配置结果。
例如，如果传递 3 个 PID，则 pResults 数组将显示每个 PID 的配置结果，如下所示。
| Pids [in] | 0x1086 | 0x98004 | 0x12004 |
| pResults [out] | S_OK | E_INVALIDARG | S_OK |
快照配置在显式禁用或进程退出之前有效。