Função SetLogFileSizeWithPolicy (clfsmgmtw32.h)

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