Leer en inglés

Compartir a través de


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

Consulte también

ClfsAdvanceTailCallback

ClfsLogGrowthCompleteCallback

ClfsMgmtRegisterManagedClient