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 de 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 ClfsMgmtRegisterRegisterManagedClient.

[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 usa.

[in, optional] CompletionRoutineData

No se usa.

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 de 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 instalado de directivas en el registro no es válido. Esto puede deberse a una directiva de clfsMgmtPolicyAutoShrink o directiva clfsMgmtPolicyMaximumSize.
STATUS_COULD_NOT_RESIZE_LOG
 La administración de CLFS no pudo eliminar suficientes contenedores para alcanzar el valor de NewSizeInContainers.
STATUS_LOG_POLICY_CONFLICT
 Una directiva en el registro especificado impedía que la operación se completara. Esto puede ocurrir si la administración de CLFS no pudo agregar suficientes contenedores al registro para alcanzar el valor de NewSizeInContainers. Esto puede deberse a un conflicto con una directiva establecida por el cliente.
 

Esta rutina también puede devolver otros valores NTSTATUS de .

Requisitos

Requisito Valor
cliente mínimo admitido Disponible en Windows 7 y versiones posteriores de Windows.
de la plataforma de destino de Escritorio
encabezado de wdm.h
DLL de Clfs.sys

Consulte también

rutinas de la biblioteca de administración de CLFS