GetTraceLoggerHandle 함수(evntrace.h)

  • 아티클

RegisterTraceGuids 기반("클래식") 이벤트 공급자는 GetTraceLoggerHandle 함수를 사용하여 이벤트를 작성해야 하는 이벤트 추적 세션의 핸들을 검색합니다.

공급자는 ControlCallback 함수에서 이 함수를 호출합니다.

구문

TRACEHANDLE WMIAPI GetTraceLoggerHandle(
  [in] PVOID Buffer
);

매개 변수

[in] Buffer

WNODE_HEADER 구조체에 대한 포인터입니다. ETW는 Buffer 매개 변수에서 공급자의 ControlCallback 함수에 이 구조를 전달합니다.

WNODE_HEADERHistoricalContext 멤버에는 세션의 핸들이 포함됩니다.

반환 값

함수가 성공하면 이벤트 추적 세션 핸들을 반환합니다.

함수가 실패하면 INVALID_HANDLE_VALUE 반환합니다. 확장 오류 정보를 가져오려면 GetLastError 함수를 호출합니다.

설명

GetTraceEnableFlags 및 GetTraceEnableLevel 함수를 호출할 때 핸들을 사용하여 EnableTrace 함수에 전달된 사용 플래그 및 수준 값을 검색합니다.

예제

GetTraceLoggerHandle을 사용하는 예제는 MOF를 사용하여 이벤트 데이터 검색을 참조하세요.

요구 사항

   
지원되는 최소 클라이언트 Windows 2000 Professional [데스크톱 앱 | UWP 앱]
지원되는 최소 서버 Windows 2000 Server [데스크톱 앱 | UWP 앱]
대상 플랫폼 Windows
헤더 evntrace.h
라이브러리 Advapi32.lib
DLL Advapi32.dll

추가 정보

GetTraceEnableFlags

GetTraceEnableLevel