SnapshotOnDemand
지정된 프로세스에 대해 지정된 SnapshotType에 대해 한 번 스냅샷을 생성한 다음 추적 버퍼로 내보냅니다. 이 API를 호출하기 전에 스냅샷을 구성해야 합니다.
구문
HRESULT SnapshotOnDemand
([in] SnapshotType snapshotType,
[in] ULONG* pids,
[in] ULONG cPids);
매개 변수
snapshotType
[in] SnapshotType.
참고: 현재 사용 가능한 유일한 SnapshotType은 SnapshotType_Heap입니다.
pids
[in] 프로세스 ID 배열에 대한 포인터입니다. 최대 8개의 프로세스 ID를 지정할 수 있습니다.
cPids
[in] 배열의 프로세스 ID 수입니다. 최대 수는 8입니다.
반환 값
다음 테이블에서는 가능한 반환 값에 대해 설명합니다.
반환 값 | 설명 |
---|---|
S_OK | 지정된 프로세스에 대해 성공적으로 스냅샷이 작성되었습니다. |
E_WPRC_EXCEEDED_HEAP_SNAPSHOT_PIDS | PID의 수가 최대 허용 한도를 초과했습니다. 최대 8개의 pid를 지정할 수 있습니다. |