GetTraceEnableFlags 함수(evntrace.h)
RegisterTraceGuids 기반("클래식") 이벤트 공급자는 GetTraceEnableFlags 함수를 사용하여 추적 컨트롤러에서 지정한 사용 플래그를 검색하여 추적할 이벤트의 범주를 나타냅니다.
공급자는 ControlCallback 함수에서 이 함수를 호출합니다.
구문
ULONG WMIAPI GetTraceEnableFlags(
[in] TRACELOGGER_HANDLE TraceHandle
);
매개 변수
[in] TraceHandle
GetTraceLoggerHandle 함수를 호출하여 얻은 이벤트 추적 세션에 대한 핸들입니다.
반환 값
EnableTrace 함수를 호출할 때 EnableFlag 매개 변수에 지정된 컨트롤러 값을 반환합니다.
함수가 실패했는지 또는 컨트롤러가 사용 플래그를 0으로 설정했는지 확인하려면 다음 단계를 수행합니다.
- SetLastError 함수를 호출하여 마지막 오류를 ERROR_SUCCESS 설정합니다.
- GetTraceEnableFlags 함수를 호출하여 사용 플래그를 검색합니다.
- enable flags 값이 0이면 GetLastError 함수를 호출하여 마지막으로 알려진 오류를 검색합니다.
- 마지막으로 알려진 오류가 ERROR_SUCCESS 컨트롤러는 사용 플래그를 0으로 설정합니다. 그렇지 않으면 마지막으로 알려진 오류로 GetTraceEnableFlags 함수가 실패했습니다.
설명
공급자는 이 값을 사용하여 생성되는 이벤트를 제어할 수 있습니다. 예를 들어 공급자는 이벤트를 논리적 범주의 이벤트로 그룹화하고 이 값을 사용하여 생성을 사용하거나 사용하지 않도록 설정할 수 있습니다.
예제
GetTraceEnableFlags를 사용하는 예제는 MOF를 사용하여 이벤트 데이터 검색을 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 Professional [데스크톱 앱 | UWP 앱] |
| 지원되는 최소 서버 | Windows 2000 Server [데스크톱 앱 | UWP 앱] |
| 대상 플랫폼 | Windows |
| 헤더 | evntrace.h |
| 라이브러리 | Advapi32.lib |
| DLL | Advapi32.dll |