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


Функция SaferRecordEventLogEntry (winsafer.h)

Функция SaferRecordEventLogEntry сохраняет сообщения в журнале событий.

Синтаксис

BOOL SaferRecordEventLogEntry(
  [in] SAFER_LEVEL_HANDLE hLevel,
  [in] LPCWSTR            szTargetPath,
       LPVOID             lpReserved
);

Параметры

[in] hLevel

SAFER_LEVEL_HANDLE, содержащий сведения о правиле для отправки в журнал событий.

[in] szTargetPath

Путь к файлу, который пытался выполнить.

lpReserved

Зарезервировано для последующего использования. Этот параметр должен иметь значение NULL.

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

Значение TRUE , если функция выполнена успешно; в противном случае — FALSE. Чтобы получить дополнительные сведения об ошибке, вызовите Метод GetLastError.

Комментарии

Если SaferIdentifyLevel возвращает SAFER_LEVEL_HANDLE с идентификатором LevelId, который не является SAFER_LEVELID_FULLYTRUSTED (0x40000), то для упрощения устранения неполадок можно вызвать SaferRecordEventLogEntry . Например, нажатие кнопки в excel.exe может попытаться запустить другой процесс, который не является полностью доверенным. Это может отобразить неясное сообщение об ошибке, так как программа переназначила ошибку, возвращенную из CreateProcess. Чтобы упростить устранение неполадок, некоторые функции Safer вызывают SaferRecordEventLogEntry для отправки события в журнал событий.

Требования

   
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header winsafer.h
Библиотека Advapi32.lib
DLL Advapi32.dll
Набор API ext-ms-win-advapi32-safer-l1-1-0 (появилась в Windows 8)