Opérations de journalisation des événements
Les fonctions OpenEventLog, OpenBackupEventLog, RegisterEventSource, DeregisterEventSource et CloseEventLog ouvrent et ferment les handles du journal des événements.
Le tableau suivant montre les opérations qui peuvent être effectuées dans un journal des événements ouvert et la fonction correspondante pour chaque opération.
| Opération | Fonction |
|---|---|
| Sauvegarde | BackupEventLog |
| Effacer | ClearEventLog |
| Monitor | 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 afin que les opérations puissent être effectuées sur le serveur distant. Utilisez OpenEventLog pour lire ou effectuer des opérations administratives (sauvegarde, effacer, surveiller et interroger) sur 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 à 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 garanti pour être écrit séquentiellement en tant qu’enregistrement complet dans le journal. La liste suivante décrit la façon dont 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 un status « fin du 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 claire avant de recevoir une opération de lecture : l’opération de lecture échoue avec « fin du fichier » status.
- Le service de journalisation des événements effectue 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.