Función SaferRecordEventLogEntry (winsafer.h)

  • Artículo

La función SaferRecordEventLogEntry guarda mensajes en un registro de eventos.

Sintaxis

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

Parámetros

[in] hLevel

SAFER_LEVEL_HANDLE que contiene los detalles de la regla que se van a enviar al registro de eventos.

[in] szTargetPath

Ruta de acceso del archivo que intentó ejecutarse.

lpReserved

Reservado para uso futuro. Este parámetro debe establecerse en NULL.

Valor devuelto

TRUE si la función se realiza correctamente; de lo contrario, FALSE. Para obtener información de error extendida, llame a GetLastError.

Comentarios

Si SaferIdentifyLevel devuelve un SAFER_LEVEL_HANDLE con un LevelId que no sea SAFER_LEVELID_FULLYTRUSTED (0x40000), se puede llamar a SaferRecordEventLogEntry para facilitar la solución de problemas. Por ejemplo, hacer clic en un botón en excel.exe podría intentar iniciar otro proceso que no es de plena confianza. Esto podría mostrar un mensaje de error oculto porque el programa reasignaba el error devuelto por CreateProcess. Para facilitar la solución de problemas, algunas funciones más seguras llaman a SaferRecordEventLogEntry para enviar un evento al registro de eventos.

Requisitos

   
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado winsafer.h
Library Advapi32.lib
Archivo DLL Advapi32.dll
Conjunto de API ext-ms-win-advapi32-safer-l1-1-0 (introducido en Windows 8)