Función ClfsReadNextLogRecord (wdm.h)
La rutina ClfsReadNextLogRecord lee el siguiente registro de una secuencia, en relación con el registro actual en un contexto de lectura.
Sintaxis
CLFSUSER_API NTSTATUS ClfsReadNextLogRecord(
[in, out] PVOID pvReadContext,
[out] PVOID *ppvBuffer,
[out] PULONG pcbBuffer,
[in, out] PCLFS_RECORD_TYPE peRecordType,
[in, optional] PCLFS_LSN plsnUser,
[out] PCLFS_LSN plsnUndoNext,
[out] PCLFS_LSN plsnPrevious,
[out] PCLFS_LSN plsnRecord
);
Parámetros
[in, out] pvReadContext
Puntero a un contexto de lectura que el autor de la llamada obtuvo anteriormente llamando a ClfsReadLogRecord o ClfsReadRestartArea.
[out] ppvBuffer
Puntero a una variable que recibe un puntero a un búfer que contiene los datos de registro.
[out] pcbBuffer
Puntero a una variable con tipo ULONG que recibe el tamaño, en bytes, del búfer al que apunta *ppvBuffer. Esta es la longitud del búfer de datos del registro leído.
[in, out] peRecordType
Puntero a una variable de tipo CLFS_RECORD_TYPE. El llamador debe establecer este parámetro en uno de los valores siguientes.
| Valor | Registro que se leerá |
|---|---|
| ClfsDataRecord | El siguiente registro de datos. |
| ClfsRestartRecord | Siguiente registro de reinicio. |
| ClfsClientRecord | El siguiente registro que es un registro de datos o un registro de reinicio. |
[in, optional] plsnUser
Puntero a una estructura CLFS_LSN que proporciona el LSN del registro que se va a leer. El registro especificado se lee en lugar del registro que se habría leído según el modo (ClfsContextUndoNext, ClfsContextPrevious o ClfsContextForward) del contexto de lectura (pvReadContext). El LSN proporcionado en plsnUser debe ser menor que el LSN actual del contexto de lectura. Este parámetro puede ser NULL.
[out] plsnUndoNext
Puntero a una estructura de CLFS_LSN que recibe el LSN de deshacer siguiente del registro que se lee.
[out] plsnPrevious
Puntero a una estructura CLFS_LSN que recibe el LSN anterior del registro leído.
[out] plsnRecord
Puntero a una estructura CLFS_LSN que recibe el LSN del registro leído.
Valor devuelto
ClfsReadNextLogRecord devuelve STATUS_SUCCESS si se realiza correctamente; de lo contrario, devuelve uno de los códigos de error definidos en Ntstatus.h.
Comentarios
Para obtener una explicación de los conceptos y la terminología de CLFS, consulte Common Log File System.
Para obtener información sobre cómo leer registros de secuencias CLFS, vea Lectura de registros de datos de un Stream CLFS y Lectura de registros de reinicio desde un Stream CLFS.
Los contextos de lectura no son seguros para subprocesos. Los clientes son responsables de serializar el acceso a contextos de lectura.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Disponible en Windows Server 2003 R2, Windows Vista y versiones posteriores de Windows. |
| Plataforma de destino | Escritorio |
| Encabezado | wdm.h (incluya Wdm.h) |
| Library | Clfs.lib |
| Archivo DLL | Clfs.sys |
| IRQL | <= APC_LEVEL |