Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Note
L’API De journalisation des événements a été conçue pour les applications qui s’exécutent sur le système d’exploitation Windows Server 2003, Windows XP ou Windows 2000. Dans Windows Vista, l’infrastructure de journalisation des événements a été repensée. Les applications conçues pour s’exécuter sur les systèmes d’exploitation Windows Vista ou ultérieur doivent désormais utiliser le journal des événements Windows.
Les OpenEventLog, OpenBackupEventLog, RegisterEventSource, DeregisterEventSourceet fonctions CloseEventLog ouvrent et ferment les handles du journal des événements.
Le tableau suivant présente les opérations qui peuvent être effectuées sur un journal des événements ouvert et la fonction correspondante pour chaque opération.
| Opération | Fonction |
|---|---|
| Sauvegarde | BackupEventLog |
| Clair | ClearEventLog |
| Moniteur | NotifyChangeEventLog |
| Requête | GetOldestEventLogRecord, GetNumberOfEventLogRecords |
| Lire | ReadEventLog |
| Écrire | ReportEvent |
Les fonctions OpenEventLog et ReportEvent prennent un nom de serveur facultatif comme paramètre afin que les opérations puissent être effectuées sur le serveur distant. Utilisez OpenEventLog pour lire ou effectuer des opérations d’administration (sauvegarde, effacer, surveiller et interroger) dans le journal et utilisez RegisterEventSource pour écrire dans le journal.
Chaque appel à une fonction de journalisation des événements est une opération atomique. Lorsque vous lisez le journal des événements, seuls les enregistrements d’événements entiers sont retournés. Lorsque vous écrivez dans le journal des événements, chaque enregistrement d’événement est garanti d’être écrit séquentiellement en tant qu’enregistrement complet dans le journal. La liste suivante décrit comment le service de journalisation des événements gère des conditions spéciales :
- Le service de journalisation des événements reçoit une opération de lecture et une opération d’écriture en même temps : si la position de lecture se trouve à la fin du fichier, l’opération de lecture échoue avec un état « fin de fichier » (si l’opération d’écriture n’a pas été terminée) ou renvoie le nouvel enregistrement (si l’opération d’écriture a été terminée).
- Le service de journalisation des événements termine une opération claire avant de recevoir une opération de lecture : l’opération de lecture échoue avec l’état « fin du fichier ».
- Le service de journalisation des événements termine une opération claire avant de recevoir une opération d’écriture : l’opération effacer tronque le journal, puis l’opération d’écriture ajoute le nouvel enregistrement au début du journal.