SaferRecordEventLogEntry-Funktion (winsafer.h)

Artikel
08/27/2023

Die SaferRecordEventLogEntry-Funktion speichert Nachrichten in einem Ereignisprotokoll.

Syntax

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

Parameter

[in] hLevel

SAFER_LEVEL_HANDLE, der die Details der Regel enthält, die an das Ereignisprotokoll gesendet werden soll.

[in] szTargetPath

Pfad der Datei, die versucht hat, auszuführen.

lpReserved

Für die zukünftige Verwendung reserviert. Dieser Parameter sollte auf NULL festgelegt werden.

Rückgabewert

TRUE , wenn die Funktion erfolgreich ist; andernfalls FALSE. Rufen Sie GetLastError auf, um erweiterte Fehlerinformationen zu erhalten.

Hinweise

Wenn SaferIdentifyLevel einen SAFER_LEVEL_HANDLE mit einer LevelId zurückgibt, die nichts anderes als SAFER_LEVELID_FULLYTRUSTED (0x40000) ist, kann SaferRecordEventLogEntry aufgerufen werden, um die Problembehandlung zu erleichtern. Wenn Sie beispielsweise auf eine Schaltfläche in excel.exe klicken, können Sie versuchen, einen anderen Prozess zu starten, der nicht vollständig vertrauenswürdig ist. Dadurch wird möglicherweise eine obskure Fehlermeldung angezeigt, da das Programm den von CreateProcess zurückgegebenen Fehler neu zugeordnet hat. Um die Problembehandlung zu vereinfachen, rufen einige sicherere Funktionen SaferRecordEventLogEntry auf, um ein Ereignis an das Ereignisprotokoll zu senden.

Anforderungen


Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winsafer.h
Bibliothek	Advapi32.lib
DLL	Advapi32.dll
APIs	ext-ms-win-advapi32-safer-l1-1-0 (eingeführt in Windows 8)

Freigeben über