Operaciones de registro de eventos

Las funciones OpenEventLog, OpenBackupEventLog, RegisterEventSource, DeregisterEventSource y CloseEventLog abren y cierran los identificadores del registro de eventos.

En la tabla siguiente se muestran las operaciones que se pueden realizar en un registro de eventos abiertos y la función correspondiente para cada operación.

Operación	Función
Copia de seguridad	BackupEventLog
Borrar	ClearEventLog
Monitor	NotifyChangeEventLog
Consultar	GetOldestEventLogRecord, GetNumberOfEventLogRecords
Leer	ReadEventLog
Escritura	ReportEvent

 

Las funciones OpenEventLog y ReportEvent toman un nombre de servidor opcional como parámetro para que las operaciones se puedan realizar en el servidor remoto. Use OpenEventLog para leer o realizar operaciones administrativas (copia de seguridad, borrar, supervisar y consultar) en el registro y usar RegisterEventSource para escribir en el registro.

Cada llamada a una función de registro de eventos es una operación atómica. Cuando se lee desde el registro de eventos, solo se devuelven registros de eventos completos. Al escribir en el registro de eventos, se garantiza que cada registro de eventos se escriba secuencialmente como un registro completo en el registro. En la lista siguiente se describe cómo el servicio de registro de eventos controla las condiciones especiales:

• El servicio de registro de eventos recibe una operación de lectura y una operación de escritura al mismo tiempo: si la posición de lectura está al final del archivo, se produce un error en la operación de lectura con un estado de "fin de archivo" (si no se ha completado la operación de escritura) o devuelve el nuevo registro (si se ha completado la operación de escritura).
• El servicio de registro de eventos completa una operación clara antes de recibir una operación de lectura: se produce un error en la operación de lectura con el estado "final de archivo".
• El servicio de registro de eventos completa una operación clara antes de recibir una operación de escritura: la operación clear trunca el registro y, a continuación, la operación de escritura agrega el nuevo registro al principio del registro.