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

Consulte también

CLFS_LSN

ClfsReadLogRecord

ClfsReadRestartArea