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

추가 정보

EVENT_INFO_CLASS

EventRegister