다음을 통해 공유


SnapshotOnDemand

지정된 프로세스에 대해 지정된 SnapshotType에 대해 한 번 스냅샷을 생성한 다음 추적 버퍼로 내보냅니다. 이 API를 호출하기 전에 스냅샷을 구성해야 합니다.

구문

HRESULT SnapshotOnDemand
([in] SnapshotType snapshotType,
[in] ULONG* pids,
[in] ULONG cPids);

매개 변수

snapshotType
[in] SnapshotType.
참고: 현재 사용 가능한 유일한 SnapshotTypeSnapshotType_Heap입니다.
pids
[in] 프로세스 ID 배열에 대한 포인터입니다. 최대 8개의 프로세스 ID를 지정할 수 있습니다.
cPids
[in] 배열의 프로세스 ID 수입니다. 최대 수는 8입니다.

반환 값

다음 테이블에서는 가능한 반환 값에 대해 설명합니다.

반환 값 설명
S_OK 지정된 프로세스에 대해 성공적으로 스냅샷이 작성되었습니다.
E_WPRC_EXCEEDED_HEAP_SNAPSHOT_PIDS PID의 수가 최대 허용 한도를 초과했습니다. 최대 8개의 pid를 지정할 수 있습니다.