Função ClfsMgmtSetLogFileSizeAsClient (wdm.h)

Artigo
02/27/2024

A rotina ClfsMgmtSetLogFileSizeAsClient define o tamanho do arquivo de log adicionando contêineres a um log de cliente ou excluindo contêineres de um log do 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 LOG_FILE_OBJECT que representa o log do 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 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 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.

Retornar valor

A rotina 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 de políticas instaladas no log é inválido. Isso pode ser devido a uma política ClfsMgmtPolicyAutoShrink inválida ou à política ClfsMgmtPolicyMaximumSize .
STATUS_COULD_NOT_RESIZE_LOG	O gerenciamento CLFS não pôde excluir contêineres suficientes para alcançar o valor em NewSizeInContainers.
STATUS_LOG_POLICY_CONFLICT	Uma política no log especificado impediu a conclusão da operação. Isso poderá ocorrer se o gerenciamento 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
Cliente mínimo com suporte	Disponível no Windows 7 e versões posteriores do Windows.
Plataforma de Destino	Área de Trabalho
Cabeçalho	wdm.h
DLL	Clfs.sys

Confira também

Rotinas da Biblioteca de Gerenciamento CLFS

Compartilhar via