Función ClfsMgmtHandleLogFileFull (wdm.h)
La rutina ClfsMgmtHandleLogFileFull intenta disponer de más espacio en un registro. Puede que haya más espacio disponible agregando contenedores al registro, o puede pedir a los clientes que muevan sus colas de registro.
Sintaxis
CLFSUSER_API NTSTATUS ClfsMgmtHandleLogFileFull(
[in] CLFS_MGMT_CLIENT Client
);
Parámetros
[in] Client
El cliente que solicita la administración de CLFS para que el espacio esté disponible en el registro. El valor de este parámetro debe ser la estructura CLFS_MGMT_CLIENT que se obtiene a través de una llamada a la rutina ClfsMgmtRegisterRegisterManagedClient.
Valor devuelto
La rutina ClfsMgmtHandleLogFileFull devuelve uno de los siguientes valores NTSTATUS:
| Código devuelto | Descripción |
|---|---|
| STATUS_INVALID_PARAMETER | El cliente no administra un registro. |
| STATUS_INVALID_PARAMETER_1 | El valor proporcionado para el parámetro cliente de era NULL o no representa un cliente válido. |
| STATUS_LOG_FULL_HANDLER_IN_PROGRESS | La administración de CLFS ya está intentando resolver una condición completa del archivo de registro para este cliente. |
| STATUS_UNSUCCESSFUL | La administración de CLFS no pudo procesar la solicitud. |
| STATUS_PENDING | La administración de CLFS está procesando la solicitud para crear espacio en el registro. |
| STATUS_SUCCESS | La cantidad de espacio solicitada está disponible en el registro. |
Observaciones
Para que haya más espacio disponible en el registro, la rutina ClfsMgmtHandleLogFileFull primero intenta agregar más contenedores al registro de acuerdo con la tasa de crecimiento, el nuevo tamaño de contenedor y las directivas de tamaño máximo. Si no se pueden agregar más contenedores, la rutina de ClfsMgmtHandleLogFileFull intenta liberar espacio existente invocando una o varias funciones de ClfsAdvanceTailCallback clientes.
Si la rutina ClfsMgmtHandleLogFileFull devuelve STATUS_PENDING, se llamará a la función ClfsLogGrowthCompleteCall back cuando se haya completado la solicitud de espacio en el registro.
Si la rutina ClfsMgmtHandleLogFileFull devuelve STATUS_LOG_FULL_HANDLER_IN_PROGRESS, el cliente ya ha solicitado la administración de CLFS para controlar una condición completa del archivo de registro. No se llamará a la función ClfsLogLogGrowthCompleteCallback del cliente.
Si la rutina clfsMgmtHandleLogFileFull devuelve STATUS_SUCCESS, la llamada se completó sincrónicamente y la función clfsLogGrowthCompleteCall back del cliente no se invocará.
Si la rutina de ClfsMgmtHandleLogFileFull devuelve STATUS_PENDING, la administración de CLFS se encuentra en el proceso de intentar liberar espacio en el registro y llamará a la función clfsLogGrowthCompleteCall back del cliente cuando se haya controlado la condición completa del archivo de registro. Si el registro está anclado, la administración de CLFS llamará al clfsLogGrowthCompleteCallback función con el parámetro LogIsPinned establecido en TRUE antes de que la rutina ClfsMgmtHandleLogFileFull devuelva STATUS_PENDING.
Es posible que se pueda llamar a la función ClfsLogGrowthCompleteCall back del cliente antes de llamar a la llamada a ClfsMgmtHandleLogFileFull devuelve.
Si la rutina ClfsMgmtHandleLogFileFull devuelve STATUS_PENDING, no debe llamar a la función ClfsMgmtHandleLogFileFull para este cliente hasta que se haya llamado a la función ClfsLogGrowthCompleteCallback del cliente.
Requisitos
| Requisito | Valor |
|---|---|
| de la plataforma de destino de | Escritorio |
| encabezado de | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| biblioteca de | Clfs.lib |
| DLL de | Clfs.sys |
| irQL | IRQL <= APC_LEVEL |