ConfigSnapshotByPID
Настраивает snapshot с помощью предоставленного идентификатора процесса.
Синтаксис
HRESULT ConfigSnapshotByPID
([in, out] ULONG* pids,
[in] ULONG cPids,
[in] VARIANT_BOOL fEnable);
Параметры
Pid
[in] Указатель на массив идентификаторов процессов.
cPids
[in] Количество идентификаторов процессов в массиве.
fEnable
[in] Логическое значение, указывающее, следует ли включать или отключать snapshot.
Возвращаемое значение
В следующей таблице описаны возможные возвращаемые значения.
| Возвращаемое значение | Описание: |
|---|---|
| S_OK | Настройка для указанных процессов прошла успешно. |
| S_FALSE | Настройка была частично успешной. Дополнительные сведения о том, какой процесс завершился сбоем, см. в разделе pResults . |
| E_WPRC_FAILED_TO_CONFIGURE_HEAP_SNAPSHOT_PIDS | Не удалось настроить элемент управления стеком кучи для PID.S. |
Комментарии
Если функция возвращает частичный сбой (S_FALSE), это означает, что не все процессы в массиве идентификаторов процессов настроены успешно. Чтобы определить, какие процессы завершили сбой, используйте функцию ConfigSnapshotByPIDEx .
Конфигурация snapshot действительна до тех пор, пока она не будет явно отключена или процесс не завершится.