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

Статья
08/23/2023

Настраивает поставщик событий трассировки событий 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

Поделиться через