Função ClfsMgmtSetLogFileSize (wdm.h)

  • Artigo

A rotina ClfsMgmtSetLogFileSize adiciona contêineres a um log ou exclui contêineres de um log.

Sintaxe

CLFSUSER_API NTSTATUS ClfsMgmtSetLogFileSize(
  [in]           PLOG_FILE_OBJECT                     LogFile,
  [in]           PULONGLONG                           NewSizeInContainers,
  [out]          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 CLFS ou um fluxo dentro do log, ao qual os contêineres estão sendo adicionados ou excluídos.

[in] NewSizeInContainers

Um ponteiro para o tamanho do log solicitado. O chamador define esse parâmetro como um dos valores a seguir.

Valor Significado
0 Impor a política de tamanho mínimo. Para obter mais informações sobre essa política, consulte ClfsMgmtInstallPolicy.

Se uma política de tamanho mínimo não estiver instalada, ocorrerá uma das seguintes opções:

  • Se o log atualmente tiver menos de 2 contêineres, o log será expandido para um tamanho de 2 contêineres.
  • Se o log tiver atualmente 2 ou mais contêineres, nenhuma alteração será feita e a chamada será bem-sucedida.
Se uma política de tamanho mínimo estiver instalada, ocorrerá uma das seguintes opções:
  • Se o log atualmente tiver menos do que o número mínimo de contêineres especificado pela política de tamanho mínimo, o log se expandirá para o número mínimo de contêineres especificado pela política.
  • Se o número de contêineres no log for maior ou igual ao número mínimo de contêineres especificado pela política de tamanho mínimo, nenhuma alteração será feita e a chamada terá êxito sem erros.
1 Valor inválido. A chamada falha e retorna STATUS_INVALID_VALUE.
2 a 1023 O tamanho desejado do log, expresso como o número de contêineres.

Se esse número for menor que o número mínimo de contêineres especificado pela política instalada, a chamada falhará com ERROR_COULD_NOT_RESIZE_LOG.

Se esse número for maior que o número máximo de contêineres especificado pela política instalada, o log se expandirá apenas até o número máximo de contêineres especificado pela política e a chamada terá êxito sem erros.
1024 a MAXULONGLONG Se nenhuma política de tamanho máximo estiver instalada, a chamada falhará e retornará ERROR_LOG_POLICY_CONFLICT.

Se uma política de tamanho máximo estiver instalada, o log se expandirá para o número máximo de contêineres especificado pela política de tamanho máximo e a chamada terá êxito sem erros.
 

Para determinar o tamanho real do log, que pode ser diferente do tamanho solicitado, use o parâmetro ResultingSizeInContainers .

[out] ResultingSizeInContainers

Um ponteiro para o tamanho do log resultante. Se tiver êxito, a rotina gravará o tamanho real do log, expresso como o número de contêineres no log, no local apontado por esse parâmetro.

[in, optional] CompletionRoutine

Não usado. Definido como NULL.

[in, optional] CompletionRoutineData

Não usado. Definido como NULL.

Retornar valor

A rotina ClfsMgmtSetLogFileSize retorna um dos seguintes valores NTSTATUS:

Código de retorno Descrição
STATUS_SUCCESS
 O tamanho do arquivo de log foi definido. O parâmetro ResultingSizeInContainers contém o tamanho atual do log.
STATUS_UNSUCCESSFUL
 O gerenciamento CLFS não pôde definir o tamanho do arquivo de log.
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
 Há um conflito entre o tamanho máximo e as políticas de tamanho mínimo para o log.
STATUS_COULD_NOT_RESIZE_LOG
 O gerenciamento CLFS não pôde excluir contêineres suficientes para alcançar NewSizeInContainers.
STATUS_LOG_POLICY_CONFLICT
 O gerenciamento CLFS não pôde adicionar contêineres suficientes ao log para alcançar NewSizeInContainers. Isso pode ocorrer devido a um conflito com uma política definida pelo cliente.
 

Essa rotina também pode retornar outros valores NTSTATUS.

Comentários

A rotina ClfsMgmtSetLogFileSize normalmente é usada somente quando um cliente é iniciado ou interrompido. Não chame a rotina ClfsMgmtSetLogFileSize de dentro da função ClfsAdvanceTailCallback .

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível a partir do Windows Server 2003 R2 e do Windows Vista.
Plataforma de Destino Área de Trabalho
Cabeçalho wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Biblioteca Clfs.lib
DLL Clfs.sys
IRQL <= APC_LEVEL

Confira também

CLFS_MGMT_POLICY_TYPE

ClfsMgmtInstallPolicy