Función ClfsReadPreviousRestartArea (wdm.h)
La rutina ClfsReadPreviousRestartArea lee el registro de reinicio anterior con respecto al 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 ejecuta 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.
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.
Los clientes anexan registros de reinicio a un registro CLFS llamando a ClfsWriteRestartArea.
Con la rutina ReadPreviousLogRestartArea, los clientes pueden implementar una forma de punto de comprobación aproximada. Por ejemplo, el estado del punto de control podría constar de los registros delimitados por dos o más registros de reinicio.
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 |