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 |
스냅샷 구성은 명시적으로 사용하지 않도록 설정하거나 프로세스가 종료할 때까지 유효합니다.