SaferRecordEventLogEntry, fonction (winsafer.h)

Article
08/27/2023

La fonction SaferRecordEventLogEntry enregistre les messages dans un journal des événements.

Syntaxe

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

Paramètres

[in] hLevel

SAFER_LEVEL_HANDLE qui contient les détails de la règle à envoyer au journal des événements.

[in] szTargetPath

Chemin du fichier qui a tenté de s’exécuter.

lpReserved

Réservé pour un usage futur. Ce paramètre doit avoir la valeur NULL.

Valeur retournée

TRUE si la fonction réussit ; sinon, FALSE. Pour obtenir des informations d’erreur étendues, appelez GetLastError.

Remarques

Si SaferIdentifyLevel retourne un SAFER_LEVEL_HANDLE avec un LevelId autre que SAFER_LEVELID_FULLYTRUSTED (0x40000), SaferRecordEventLogEntry peut être appelé pour faciliter la résolution des problèmes. Par exemple, cliquer sur un bouton dans excel.exe peut tenter de lancer un autre processus qui n’est pas entièrement approuvé. Cela peut afficher un message d’erreur obscur, car le programme a réapplique l’erreur renvoyée par CreateProcess. Pour faciliter la résolution des problèmes, certaines fonctions Safer appellent SaferRecordEventLogEntry pour envoyer un événement au journal des événements.

Configuration requise


Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winsafer.h
Bibliothèque	Advapi32.lib
DLL	Advapi32.dll
Ensemble d’API	ext-ms-win-advapi32-safer-l1-1-0 (introduit dans Windows 8)

Partager via