Opérations de journalisation des événements

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.

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.