Función ClfsReadRestartArea (wdm.h)

La rutina ClfsReadRestartArea lee el registro de reinicio que se escribió más recientemente en una secuencia CLFS especificada.

Sintaxis

CLFSUSER_API NTSTATUS ClfsReadRestartArea(
  [in, out] PVOID     pvMarshalContext,
  [out]     PVOID     *ppvRestartBuffer,
  [out]     PULONG    pcbRestartBuffer,
  [out]     PCLFS_LSN plsn,
  [out]     PVOID     *ppvReadContext
);

Parámetros

[in, out] pvMarshalContext

Puntero a un contexto opaco que representa un área de serialización asociada a una secuencia CLFS. El autor de la llamada obtuvo anteriormente este puntero llamando a ClfsCreateMarshallingArea.

[out] ppvRestartBuffer

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

[out] pcbRestartBuffer

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

[out] plsn

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

[out] ppvReadContext

Puntero a una variable que recibe un puntero a un contexto de lectura opaco. El autor de la llamada puede pasar este contexto a ClfsReadPreviousRestartArea o ClfsReadNextLogRecord. Cuando el autor de la llamada haya terminado de usar el contexto de lectura, debe liberar el contexto llamando a ClfsTerminateReadLog.

Valor devuelto

ClfsReadRestartArea 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

Consulte también

ClfsCreateMarshallingArea

ClfsReadNextLogRecord

ClfsReadPreviousRestartArea

ClfsTerminateReadLog