Operazioni di registrazione eventi
Le funzioni OpenEventLog, OpenBackupEventLog, RegisterEventSource, DeregisterEventSource e CloseEventLog aprono e chiudono gli handle del registro eventi.
La tabella seguente illustra le operazioni che possono essere eseguite in un registro eventi aperto e la funzione corrispondente per ogni operazione.
| Operazione | Funzione |
|---|---|
| Backup | BackupEventLog |
| Cancella | ClearEventLog |
| Monitoraggio | NotifyChangeEventLog |
| Query | GetOldestEventLogRecord, GetNumberOfEventLogRecords |
| Read | ReadEventLog |
| Write | Reportevent |
Le funzioni OpenEventLog e ReportEvent accettano un nome server facoltativo come parametro in modo che le operazioni possano essere eseguite nel server remoto. Usare OpenEventLog per leggere o eseguire operazioni amministrative (backup, cancellazione, monitoraggio e query) nel log e usare RegisterEventSource per la scrittura nel log.
Ogni chiamata a una funzione di registrazione eventi è un'operazione atomica. Quando si legge dal registro eventi, vengono restituiti solo i record di eventi interi. Quando si scrive nel registro eventi, ogni record evento viene scritto in sequenza come record completo nel log. L'elenco seguente descrive come il servizio di registrazione eventi gestisce condizioni speciali:
- Il servizio di registrazione eventi riceve contemporaneamente un'operazione di lettura e un'operazione di scrittura: se la posizione di lettura è alla fine del file, l'operazione di lettura ha esito negativo con lo stato di "fine del file" (se l'operazione di scrittura non è stata completata) o restituisce il nuovo record (se l'operazione di scrittura è stata completata).
- Il servizio di registrazione eventi completa un'operazione chiara prima di ricevere un'operazione di lettura: l'operazione di lettura ha esito negativo con lo stato di "fine del file".
- Il servizio di registrazione eventi completa un'operazione di cancellazione prima di ricevere un'operazione di scrittura: l'operazione di cancellazione tronca il log, quindi l'operazione di scrittura aggiunge il nuovo record all'inizio del log.