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

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

Синтаксис

EVT_HANDLE EvtOpenChannelConfig(
  [in] EVT_HANDLE Session,
  [in] LPCWSTR    ChannelPath,
  [in] DWORD      Flags
);

Параметры

[in] Session

Удаленный дескриптор сеанса, который возвращает функция EvtOpenSession . Установите значение NULL для доступа к каналу на локальном компьютере.

[in] ChannelPath

Имя канала для доступа.

[in] Flags

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

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

В случае успешного выполнения функция возвращает дескриптор в конфигурацию канала; в противном случае — NULL. Если значение РАВНО NULL, вызовите функцию GetLastError , чтобы получить код ошибки.

Комментарии

Чтобы получить свойство конфигурации, вызовите функцию EvtGetChannelConfigProperty .

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

Чтобы перечислить зарегистрированные каналы, вызовите функцию EvtOpenChannelEnum .

Чтобы закрыть дескриптор по завершении, необходимо вызвать функцию EvtClose .

Примеры

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

Требования

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

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

EvtGetChannelConfigProperty

EvtOpenChannelEnum

EvtSaveChannelConfig

EvtSetChannelConfigProperty