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 de la lectura del registro.
[in, out] peRecordType
Puntero a una variable de tipo CLFS_RECORD_TYPE. El autor de la llamada debe establecer este parámetro en uno de los valores siguientes.
| Valor | Registro que se leerá |
|---|---|
| ClfsDataRecord | El siguiente registro de datos. |
| ClfsRestartRecord | El 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, ClfsContextPreviouso 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 ejecuta correctamente; de lo contrario, devuelve uno de los códigos de error definidos en Ntstatus.h.
Observaciones
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 desde un de secuencia clFS y lectura de registros de reinicio desde un flujo de CLFS.
Los contextos de lectura no son seguros para subprocesos. Los clientes son responsables de serializar el acceso a contextos de lectura.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Disponible en Windows Server 2003 R2, Windows Vista y versiones posteriores de Windows. |
| de la plataforma de destino de | Escritorio |
| encabezado de | wdm.h (incluya Wdm.h) |
| biblioteca de | Clfs.lib |
| DLL de | Clfs.sys |
| irQL | <= APC_LEVEL |