Compartilhar via

Função SetLogFileSizeWithPolicy (clfsmgmtw32.h)

  • Artigo

Adiciona ou exclui contêineres de um log com base no estado das políticas instaladas.

Sintaxe

CLFSUSER_API BOOL SetLogFileSizeWithPolicy(
  [in]  HANDLE     hLog,
  [in]  PULONGLONG pDesiredSize,
  [out] PULONGLONG pResultingSize
);

Parâmetros

[in] hLog

Um identificador para um log.

[in] pDesiredSize

Um ponteiro para um valor que especifica o tamanho do log solicitado, expresso como um dos valores a seguir. Para o tamanho resultante real, consulte o parâmetro pResultingSize .

Valor Significado
0
 Impor a política de tamanho mínimo.

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

  • Se o log tiver menos de dois contêineres, o log será expandido para um tamanho de dois contêineres.
  • Se o log tiver dois ou mais contêineres, nenhuma alteração será feita e a chamada de função terá êxito.

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

  • Se o log 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 log tiver um número de contêineres 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 de função terá êxito sem erros.

Para obter mais informações, consulte InstallLogPolicy.
1
 Não é um valor válido; a chamada de função falha com ERROR_INVALID_PARAMETER.
2–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 de função 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á somente até o número máximo de contêineres especificado pela política e a função terá êxito sem erros.
1024 –MAXULONGLONG
 Se nenhuma política de tamanho máximo estiver instalada, a chamada de função falhará com 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 função terá êxito sem erros.

[out] pResultingSize

Um ponteiro para uma variável de dados ULONGLONG válida recebe o número de contêineres no log redimensionado após o êxito.

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame a função GetLastError.

Comentários

Os contêineres são criados usando os mesmos atributos de segurança que o arquivo .blf e são criados dentro do contexto do aplicativo, não o contexto do proprietário do arquivo .blf. Para obter mais informações sobre arquivos .blf, consulte Tipos de log. Se os contêineres forem excluídos, eles serão excluídos usando o contexto de segurança do aplicativo de chamada.

Exemplos

Para obter um exemplo que usa essa função, consulte Criando um arquivo de log.

Requisitos

   
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho clfsmgmtw32.h
Biblioteca Clfsw32.lib
DLL Clfsw32.dll

Confira também

Criando um arquivo de log

InstallLogPolicy

Tipos de log