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 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 |