EventSetInformation 함수(evntprov.h)
ETW 이벤트 공급자를 구성합니다.
구문
ULONG EVNTAPI EventSetInformation(
[in] REGHANDLE RegHandle,
[in] EVENT_INFO_CLASS InformationClass,
[in] PVOID EventInformation,
[in] ULONG InformationLength
);
매개 변수
[in] RegHandle
이벤트 공급자 등록 핸들입니다. EventRegister에서 반환하는 핸들입니다.
[in] InformationClass
이벤트 공급자에서 수행할 구성 작업을 지정하는 EVENT_INFO_CLASS 값입니다.
[in] EventInformation
이벤트 공급자를 구성할 때 사용할 데이터가 포함된 버퍼에 대한 포인터입니다. 이 버퍼의 데이터 형식은 InformationClass 매개 변수에 지정된 값에 따라 달라집니다.
InformationLength가 0인 경우 이 값이 될 NULL 수 있습니다.
[in] InformationLength
EventInformation 버퍼에 있는 데이터의 크기(바이트)입니다.
반환 값
함수가 성공하면 반환 값이 ERROR_SUCCESS.
함수가 실패하면 반환 값은 다음 오류 코드 중 하나입니다.
- ERROR_INVALID_PARAMETER: 매개 변수가 잘못되었습니다. 예를 들어 RegHandle 매개 변수가 유효한 공급자 등록 핸들이 아니거나 EventInformation 이 NULL 이지만 InformationLength 가 0이 아닌 경우 또는 지정된 InformationLength 가 지정된 InformationClass에 대해 유효하지 않은 경우 이 오류가 반환됩니다.
- ERROR_NOT_SUPPORTED: 요청이 지원되지 않습니다. InformationClass 매개 변수가 인식된 값이 아닌 경우 이 오류가 반환됩니다.
- 기타: FormatMessage 를 사용하여 반환된 오류에 대한 메시지 문자열을 가져옵니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows 8 [데스크톱 앱 | UWP 앱] |
| 지원되는 최소 서버 | Windows Server 2012 [데스크톱 앱 | UWP 앱] |
| 대상 플랫폼 | Windows |
| 헤더 | evntprov.h |
| 라이브러리 | Advapi32.lib |
| DLL | Advapi32.dll |