Функция EventSetInformation (evntprov.h)

  • Статья

Настраивает поставщик событий трассировки событий Windows.

Синтаксис

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 .

Это значение может иметь значение , NULL если InformationLength равно нулю.

[in] InformationLength

Размер (в байтах) данных в буфере EventInformation .

Возвращаемое значение

Если функция выполнена успешно, возвращаемое значение будет ERROR_SUCCESS.

Если функция завершается сбоем, возвращается один из следующих кодов ошибок.

  • ERROR_INVALID_PARAMETER: неправильный параметр. Например, эта ошибка возвращается, если параметр RegHandle не является допустимым дескриптором регистрации поставщика, если EventInformation имеет значение NULL , а InformationLength — ненулевое, или если указанный Параметр InformationLength не является допустимым для данного Класса InformationClass.
  • ERROR_NOT_SUPPORTED: запрос не поддерживается. Эта ошибка возвращается, если параметр InformationClass не является распознаваемым значением.
  • Другое. Используйте FormatMessage , чтобы получить строку сообщения для возвращаемой ошибки.

Требования

   
Минимальная версия клиента Windows 8 [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2012 [классические приложения | Приложения UWP]
Целевая платформа Windows
Header evntprov.h
Библиотека Advapi32.lib
DLL Advapi32.dll

См. также раздел

EVENT_INFO_CLASS

EventRegister