Operazioni di registrazione eventi

OpenEventLog, OpenBackupEventLog, RegisterEventSource, DeregisterEventSourcee CloseEventLog funzioni aperte e chiudere gli handle del log eventi.

Nella tabella seguente vengono illustrate le operazioni che possono essere eseguite in un registro eventi aperto e la funzione corrispondente per ogni operazione.

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 la lettura o l'esecuzione di 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 di eventi 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 un'operazione di lettura e un'operazione di scrittura contemporaneamente: se la posizione di lettura si trova alla fine del file, l'operazione di lettura ha esito negativo con lo stato "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 chiara 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.