EventProviderEnabled 함수(evntprov.h)
이벤트 공급자가 이벤트의 수준 및 키워드를 기반으로 특정 이벤트를 생성해야 하는지 여부를 결정합니다.
ETW가 지정된 공급자의 지정된 이벤트를 수신 대기하는 세션이 없음을 빠르게 확인할 수 있으면 FALSE 를 반환합니다. 그렇지 않으면 TRUE를 반환 합니다.
구문
BOOLEAN EVNTAPI EventProviderEnabled(
[in] REGHANDLE RegHandle,
[in] UCHAR Level,
[in] ULONGLONG Keyword
);
매개 변수
[in] RegHandle
공급자의 등록 핸들입니다. 핸들은 EventRegister에서 제공됩니다.
RegHandle이 NULL이면 EventProviderEnabled는 FALSE를 반환합니다.
[in] Level
이벤트의 심각도 또는 중요도를 설명하는 데 사용되는 8비트 숫자입니다. 이벤트 수준 값에 대한 자세한 내용은 EVENT_DESCRIPTOR 참조하세요.
[in] Keyword
이벤트 범주 집합에서 이벤트의 멤버 자격을 나타내는 데 사용되는 64비트 비트 마스크입니다. 이벤트 키워드(keyword) 값에 대한 자세한 내용은 EVENT_DESCRIPTOR 참조하세요.
반환 값
ETW가 지정된 공급자의 지정된 이벤트를 수신 대기하는 세션이 없음을 빠르게 확인할 수 있으면 FALSE 를 반환합니다. 그렇지 않으면 TRUE를 반환 합니다.
설명
이 API는 공급자 핸들, 이벤트 수준 및 이벤트 키워드(keyword) 따라 이벤트를 사용할 수 있는지(즉, 이벤트 소비자 세션이 이벤트를 수신하는 데 관심이 있는지 여부)를 확인하는 간단한 방법을 제공합니다.
참고
이 API는 보수적인 빠른 테스트를 수행합니다. 이 API는 후속 심층 필터링에서 이벤트를 기록할 세션이 없음을 결정하는 특정 경우에 true를 반환할 수 있습니다.
이 API는 EventEnabled에서 제공하는 기능과 유사한 기능을 제공합니다. 공급자가 이벤트의 전체 EVENT_DESCRIPTOR 액세스할 수 있는 경우 공급자는 EventEnabled를 사용해야 합니다. 공급자가 이벤트의 Level 및 Keyword에만 액세스할 수 있는 경우 공급자는 EventProviderEnabled를 사용해야 합니다.
대부분의 이벤트 공급자는 EventProviderEnabled를 직접 호출하지 않습니다.
- EventWrite API에는 자체 EventProviderEnabled 테스트가 포함되며 이벤트가 사용하도록 설정되지 않은 경우 즉시 반환됩니다.
- 대부분의 ETW 공급자는 EventWrite 또는 EventProviderEnabled를 직접 호출하는 대신 ETW 프레임워크(예: 매니페스트 또는 TraceLogging)를 사용합니다. ETW 프레임워크는 일반적으로 EventProviderEnabled를 호출하는 대신 사용해야 하는 자체 이벤트 사용 API를 제공합니다.
- ETW 프레임워크 구현은 일반적으로 EventProviderEnabled를 호출하는 대신 자체 공급자 상태를 검사.
자세한 내용은 EventEnabled를 참조하세요.
요구 사항
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2008 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | evntprov.h |
| 라이브러리 | Advapi32.lib |
| DLL | Advapi32.dll |