ConfigSnapshotByPIDEx
Настраивает snapshot с помощью предоставленного идентификатора процесса.
Синтаксис
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
Pid
[in] Указатель на массив идентификаторов процессов.
pResults
[вход, выход] Выделенный пользователем буфер, который будет содержать snapshot код конфигурации hresult для каждого указанного идентификатора процесса, массив передается во втором параметре.
cPids
[in] Число идентификаторов процессов в массиве.
fEnable
[in] Логическое значение, указывающее, следует ли включать или отключать snapshot.
Возвращаемое значение
В следующей таблице описаны возможные возвращаемые значения.
| Возвращаемое значение | Описание: |
|---|---|
| S_OK | Конфигурация для указанных процессов выполнена успешно. |
| S_FALSE | Настройка была частично успешной. Дополнительные сведения о том, какой процесс завершился сбоем, см. в разделе pResults. |
| E_WPRC_FAILED_TO_CONFIGURE_HEAP_SNAPSHOT_PIDS | Не удалось настроить элемент управления стеком кучи для PID.S. |
Комментарии
Когда функция возвращает хотя бы частичный сбой (S_FALSE), каждый элемент pResults отображает результат конфигурации соответствующего идентификатора процесса, переданного во втором параметре.
Например, если передать 3 pids, в массиве pResults будет отображаться результат конфигурации каждого pid, как показано ниже.
| Pids [in] | 0x1086 | 0x98004 | 0x12004 |
| pResults [out] | S_OK | E_INVALIDARG | S_OK |
Конфигурация snapshot действительна до тех пор, пока она не будет явно отключена или процесс не завершится.