Opérations de journalisation des événements
Les fonctions OpenEventLog, OpenBackupEventLog, RegisterEventSource, DeregisterEventSourceet 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 |
| Effacer | ClearEventLog |
| Superviser | NotifyChangeEventLog |
| Requête | GetOldestEventLogRecord, GetNumberOfEventLogRecords |
| Lire | ReadEventLog |
| Write | ReportEvent |
Les fonctions OpenEventLog et ReportEvent prennent un nom de serveur facultatif en tant que paramètre, de sorte que les opérations peuvent être effectuées sur le serveur distant. Utilisez OpenEventLog pour la lecture ou l’exécution d’opérations d’administration (sauvegarde, effacement, surveillance et interrogation) dans le journal, et utilisez RegisterEventSource pour l’écriture dans le journal.
Chaque appel à une fonction d’enregistrement des événements est une opération atomique. Lorsque vous lisez à partir du 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 systématiquement écrit comme un enregistrement complet dans le journal. La liste suivante décrit comment le service de journalisation des événements gère les 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 l’état de fin de fichier (si l’opération d’écriture n’est pas terminée) ou retourne le nouvel enregistrement (si l’opération d’écriture est terminée).
- Le service de journalisation des événements effectue une opération d’effacement avant de recevoir une opération de lecture : l’opération de lecture échoue avec l’État « fin de fichier ».
- Le service de journalisation des événements effectue une opération d’effacement avant de recevoir une opération d’écriture : l’opération Clear tronque le journal, puis l’opération d’écriture ajoute le nouvel enregistrement au début du journal.