Compartir a través de

Función ClfsMgmtSetLogFileSizeAsClient (wdm.h)

  • Artículo

La rutina ClfsMgmtSetLogFileSizeAsClient establece el tamaño del archivo de registro agregando contenedores a un registro de cliente o eliminando contenedores de un registro de cliente.

Sintaxis

CLFSUSER_API NTSTATUS ClfsMgmtSetLogFileSizeAsClient(
  [in]            PLOG_FILE_OBJECT                     LogFile,
  [in, optional]  CLFS_MGMT_CLIENT                     ClientCookie,
  [in]            PULONGLONG                           NewSizeInContainers,
  [out, optional] PULONGLONG                           ResultingSizeInContainers,
  [in, optional]  PCLFS_SET_LOG_SIZE_COMPLETE_CALLBACK CompletionRoutine,
  [in, optional]  PVOID                                CompletionRoutineData
);

Parámetros

[in] LogFile

Puntero a una estructura de LOG_FILE_OBJECT que representa el registro del Sistema de archivos de registro común (CLFS) o una secuencia dentro del registro, a la que se agregan o eliminan contenedores. El valor de este parámetro se obtiene mediante una llamada a la rutina ClfsCreateLogFile .

[in, optional] ClientCookie

Puntero a una cookie proporcionada por el cliente. 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 ClfsMgmtRegisterManagedClient .

[in] NewSizeInContainers

Tamaño deseado del registro, expresado en el número de contenedores. Puede haber como máximo 1024 contenedores para un archivo de registro.

[out, optional] ResultingSizeInContainers

Tamaño real del registro, expresado en el número de contenedores.

[in, optional] CompletionRoutine

No se utiliza.

[in, optional] CompletionRoutineData

No se utiliza.

Valor devuelto

La rutina ClfsMgmtSetLogFileSizeAsClient devuelve un valor NTSTATUS.

Código devuelto Descripción
STATUS_SUCCESS
 Se ha establecido el tamaño del archivo de registro.
STATUS_INVALID_PARAMETER_1
 El valor del parámetro LogFile es NULL o el contenido del parámetro NewSizeInContainers es 1.
STATUS_INVALID_PARAMETER_2
 El valor del parámetro NewSizeInContainers es NULL.
STATUS_LOG_POLICY_INVALID
 El conjunto de directivas instaladas en el registro no es válido. Esto puede deberse a una directiva ClfsMgmtPolicyAutoShrink no válida o a una directiva ClfsMgmtPolicyMaximumSize .
STATUS_COULD_NOT_RESIZE_LOG
 La administración de CLFS no pudo eliminar suficientes contenedores para alcanzar el valor en NewSizeInContainers.
STATUS_LOG_POLICY_CONFLICT
 Una directiva en el registro especificado impidió que se completara la operación. Esto puede ocurrir si la administración de CLFS no pudo agregar suficientes contenedores al registro para alcanzar el valor en NewSizeInContainers. Esto puede deberse a un conflicto con una directiva establecida por el cliente.
 

Esta rutina también podría devolver otros valores NTSTATUS.

Requisitos

Requisito Value
Cliente mínimo compatible Disponible en Windows 7 y versiones posteriores de Windows.
Plataforma de destino Escritorio
Encabezado wdm.h
Archivo DLL Clfs.sys

Consulte también

Rutinas de la biblioteca de administración de CLFS