Função ClfsMgmtSetLogFileSizeAsClient (wdm.h)

Artigo
02/07/2025

A rotina de ClfsMgmtSetLogFileSizeAsClient define o tamanho do arquivo de log adicionando contêineres a um log de cliente ou excluindo contêineres de um log de cliente.

Sintaxe

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

Um ponteiro para uma estrutura de LOG_FILE_OBJECT que representa o log CLFS (Common Log File System) ou um fluxo dentro do log, ao qual os contêineres estão sendo adicionados ou excluídos. O valor desse parâmetro é obtido por meio de uma chamada para a rotina de ClfsCreateLogFile.

[in, optional] ClientCookie

Um ponteiro para um cookie fornecido pelo cliente. O valor desse parâmetro deve ser a estrutura CLFS_MGMT_CLIENT obtida por meio de uma chamada para a rotina de ClfsMgmtRegisterManagedClient.

[in] NewSizeInContainers

O tamanho desejado do log, expresso no número de contêineres. Pode haver no máximo 1.024 contêineres para um arquivo de log.

[out, optional] ResultingSizeInContainers

O tamanho real do log, expresso no número de contêineres.

[in, optional] CompletionRoutine

Não usado.

[in, optional] CompletionRoutineData

Não usado.

Valor de retorno

A rotina de ClfsMgmtSetLogFileSizeAsClient retorna um valor NTSTATUS.

Código de retorno	Descrição
STATUS_SUCCESS	O tamanho do arquivo de log foi definido.
STATUS_INVALID_PARAMETER_1	O valor do parâmetro LogFile é NULL ou o conteúdo do parâmetro NewSizeInContainers é 1.
STATUS_INVALID_PARAMETER_2	O valor do parâmetro NewSizeInContainers é NULL.
STATUS_LOG_POLICY_INVALID	O conjunto instalado de políticas no log é inválido. Isso pode ser devido a uma política de ClfsMgmtPolicyAutoShrink in válida ou política de ClfsMgmtPolicyMaximumSize.
STATUS_COULD_NOT_RESIZE_LOG	O gerenciamento de CLFS não pôde excluir contêineres suficientes para alcançar o valor no NewSizeInContainers.
STATUS_LOG_POLICY_CONFLICT	Uma política no log especificado impediu a conclusão da operação. Isso poderá ocorrer se o gerenciamento do CLFS não puder adicionar contêineres suficientes ao log para alcançar o valor em NewSizeInContainers. Isso pode ocorrer devido a um conflito com uma política definida pelo cliente.

Essa rotina também pode retornar outros valores NTSTATUS .

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Disponível no Windows 7 e versões posteriores do Windows.
da Plataforma de Destino	Área de trabalho
cabeçalho	wdm.h
de DLL	Clfs.sys

Consulte também

rotinas da biblioteca de gerenciamento do CLFS

Compartilhar via