Функция EvtSetChannelConfigProperty (winevt.h)

Статья
08/27/2023

Задает указанное свойство конфигурации канала.

Синтаксис

BOOL EvtSetChannelConfigProperty(
  [in] EVT_HANDLE                     ChannelConfig,
  [in] EVT_CHANNEL_CONFIG_PROPERTY_ID PropertyId,
  [in] DWORD                          Flags,
  [in] PEVT_VARIANT                   PropertyValue
);

Параметры

[in] ChannelConfig

Дескриптор свойств конфигурации канала, возвращаемого функцией EvtOpenChannelConfig .

[in] PropertyId

Идентификатор устанавливаемого свойства канала. Список идентификаторов свойств см. в перечислении EVT_CHANNEL_CONFIG_PROPERTY_ID .

[in] Flags

Зарезервировано. Должен равняться нулю.

[in] PropertyValue

Задаваемое значение свойства.

Выделенный вызывающим объектом буфер, содержащий новое значение свойства конфигурации. Буфер содержит объект EVT_VARIANT . Обязательно задайте значение конфигурации и тип варианта.

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

Возвращаемый код/значение	Описание
TRUE	Функция выполнена успешно.
FALSE	Сбой функции. Чтобы получить код ошибки, вызовите функцию GetLastError .

Эта функция изменяет копию свойств конфигурации в памяти. Чтобы применить изменения, внесенные в одно или несколько свойств конфигурации, вызовите функцию EvtSaveChannelConfig .

Примеры

Пример использования этой функции см. в разделе Получение и настройка свойств конфигурации канала.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Целевая платформа	Windows
Header	winevt.h
Библиотека	Wevtapi.lib
DLL	Wevtapi.dll

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

EvtGetChannelConfigProperty

EvtOpenChannelConfig

EvtSaveChannelConfig

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