Функция 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 |