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

Статья
08/27/2023

Устанавливает подключение к удаленному компьютеру, которое можно использовать при вызове других функций журнала событий Windows.

Синтаксис

EVT_HANDLE EvtOpenSession(
  [in] EVT_LOGIN_CLASS LoginClass,
  [in] PVOID           Login,
  [in] DWORD           Timeout,
  [in] DWORD           Flags
);

Параметры

[in] LoginClass

Метод подключения, используемый для подключения к удаленному компьютеру. Возможные значения см. в перечислении EVT_LOGIN_CLASS .

[in] Login

Структура EVT_RPC_LOGIN , которая определяет удаленный компьютер, к которому требуется подключиться, учетные данные пользователя и тип проверки подлинности, используемый при подключении.

[in] Timeout

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

[in] Flags

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

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

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

Завершив работу с дескриптором сеанса, вызовите функцию EvtClose . Закрытие дескриптора сеанса также приведет к закрытию всех открытых дескрипторов, созданных в сеансе (закрытие открытых дескрипторов отменяет любые текущие действия с этими дескрипторами).

Чтобы подключиться к удаленному компьютеру, удаленный компьютер должен включить исключение "Удаленное управление журналами событий" брандмауэра Windows; В противном случае при попытке использовать дескриптор сеанса вызов приведет к ошибке с RPC_S_SERVER_UNAVAILABLE. Компьютер, к которому выполняется подключение, должен работать под управлением Windows Vista или более поздней версии.

Эта функция не проверяет учетные данные; учетные данные проверяются при первой попытке использовать дескриптор сеанса. Если учетные данные недопустимы, вызов завершится ошибкой с ERROR_ACCESS_DENIED.

Примеры

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

Требования

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

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

EVT_LOGIN_CLASS

EvtClose

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