Compartilhar via


Função SaferRecordEventLogEntry (winsafer.h)

A função SaferRecordEventLogEntry salva mensagens em um log de eventos.

Sintaxe

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

Parâmetros

[in] hLevel

SAFER_LEVEL_HANDLE que contém os detalhes da regra a ser enviada para o log de eventos.

[in] szTargetPath

Caminho do arquivo que tentou executar.

lpReserved

Reservado para uso futuro. Esse parâmetro deve ser definido como NULL.

Valor retornado

TRUE se a função for bem-sucedida; caso contrário, FALSE. Para obter informações de erro estendidas, chame GetLastError.

Comentários

Se SaferIdentifyLevel retornar um SAFER_LEVEL_HANDLE com um LevelId que não seja SAFER_LEVELID_FULLYTRUSTED (0x40000), SaferRecordEventLogEntry poderá ser chamado para facilitar a solução de problemas. Por exemplo, clicar em um botão no excel.exe pode tentar iniciar outro processo que não é totalmente confiável. Isso pode exibir uma mensagem de erro obscura porque o programa remapeou o erro retornado de CreateProcess. Para facilitar a solução de problemas, algumas funções mais seguras chamam SaferRecordEventLogEntry para enviar um evento para o log de eventos.

Requisitos

   
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho winsafer.h
Biblioteca Advapi32.lib
DLL Advapi32.dll
Conjunto de APIs ext-ms-win-advapi32-safer-l1-1-0 (introduzido no Windows 8)