UpdateHeapTrace
이 함수는 새 PID 집합, 스택 워킹 이벤트 또는 기타 ETW 세션 변경 내용으로 기존 힙 추적 세션을 업데이트합니다.
ULONG
WINAPI
UpdateHeapTrace(
_Inout_ PEVENT_TRACE_PROPERTIES Properties,
_In_z_ LPCWSTR wszSessionName,
_In_reads_opt_(cPids) const ULONG Pids[],
_In_ ULONG cPids,
_In_reads_opt_(cStackTracingEventIds) const STACK_TRACING_EVENT_ID StackTracingEventIds[],
_In_ ULONG cStackTracingEventIds
);
매개 변수
TraceHandle [out]
이벤트 추적 세션에 핸들을 저장합니다. 핸들이 잘못되면 이 매개 변수가 0으로 설정됩니다. 이 매개 변수는 INVALID_HANDLE_VALUE와 비교하면 안 됩니다. 함수가 실패하는 경우 이 핸들을 사용하지 마세요.
Properties [in, out]
세션에 대한 업데이트된 속성이 있는 EVENT_TRACE_PROPERTIES 구조에 대한 포인터입니다. 이 구조의 멤버를 지정할 수 있는 방법에 대한 자세한 내용은 ControlCode EVENT_TRACE_CONTROL_UPDATE가 있는 ControlTrace 함수를 참조하세요.
wszSessionName[in]
업데이트할 힙 추적 세션의 이름입니다. StartHeapTrace에 전달된 이름과 같아야 합니다.
Pids [in]
힙 추적을 사용하도록 설정하는 프로세스 ID의 배열입니다.
cPids [in, out]
Pids 배열의 크기입니다.
StackTracingEventIds [in]
사용하도록 설정할 힙 이벤트 스택 워킹을 지정하는 STACK_TRACING_EVENT_ID 구조의 배열입니다. NULL일 수 있습니다.
cStackTracingEventIds [in]
StackTracingEventIds 배열의 크기입니다.
반환 값
ERROR_SUCCESS는 성공을 나타냅니다.
가능한 오류 값은 다음 테이블에 설명되어 있습니다.
| 오류 값 | 설명 |
|---|---|
ERROR_ALREADY_EXISTS |
커널 로거의 단일 인스턴스만 시스템에서 실행됩니다. 다른 구성 요소가 커널 로깅을 시작한 후 이 함수가 시작하려고 하면 이 오류가 반환될 수 있습니다. |
ERROR_INVALID_FLAGS |
Properties.EnableFlags에 잘못된 추적 플래그가 있음을 나타낼 수 있습니다. |
ERROR_OUT_OF_MEMORY |
EVENT_TRACE_PROPERTIES에 대한 메모리를 할당하지 못했음을 나타냅니다. |
나열된 것 이외의 이유로 함수가 실패하면 시스템 오류 코드가 반환됩니다.
설명
None