Función ClfsReadPreviousRestartArea (wdm.h)

La rutina ClfsReadPreviousRestartArea lee el registro de reinicio anterior en relación con el registro actual en un contexto de lectura.

Sintaxis

CLFSUSER_API NTSTATUS ClfsReadPreviousRestartArea(
  [in]  PVOID     pvReadContext,
  [out] PVOID     *ppvRestartBuffer,
  [out] PULONG    pcbRestartBuffer,
  [out] PCLFS_LSN plsnRestart
);

Parámetros

[in] pvReadContext

Puntero a un contexto de lectura obtenido por una llamada anterior a ClfsReadRestartArea.

[out] ppvRestartBuffer

Puntero a una variable que recibe un puntero al búfer de datos del registro de reinicio que se lee.

[out] pcbRestartBuffer

Puntero a una variable con tipo ULONG que recibe el tamaño, en bytes, del búfer al que apunta *ppvRestartBuffer. Esta es la longitud del búfer de datos del registro de reinicio que se lee.

[out] plsnRestart

Puntero a una estructura CLFS_LSN que recibe el LSN anterior del registro de reinicio leído.

Valor devuelto

ClfsReadPreviousRestartArea devuelve STATUS_SUCCESS si se realiza correctamente; de lo contrario, devuelve uno de los códigos de error definidos en Ntstatus.h. Si no hay áreas de reinicio anteriores, el valor devuelto es STATUS_LOG_START_OF_LOG.

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.

Los clientes anexan registros de reinicio a un registro CLFS mediante una llamada a ClfsWriteRestartArea.

Con la rutina ReadPreviousLogRestartArea , los clientes pueden implementar una forma de puntos de comprobación aproximadas. Por ejemplo, el estado del punto de control podría constar de los registros delimitados por dos o más registros de reinicio.

Requisitos

Consulte también

CLFS_LSN

ClfsReadRestartArea

ClfsWriteRestartArea