Функция SetLogFileSizeWithPolicy (clfsmgmtw32.h)

  • Статья

Добавляет или удаляет контейнеры из журнала на основе состояния установленных политик.

Синтаксис

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

Параметры

[in] hLog

Дескриптор журнала.

[in] pDesiredSize

Указатель на значение, указывающее запрошенный размер журнала, выраженный в виде одного из следующих значений. Фактический результирующий размер см. в параметре pResultingSize .

Значение Значение
0
 Примените политику минимального размера.

Если политика минимального размера не установлена, происходит одно из следующих действий:

  • Если журнал содержит менее двух контейнеров, журнал будет расширен до двух контейнеров.
  • Если в журнале есть два или более контейнеров, изменения не вносятся и вызов функции завершается успешно.

Если установлена политика минимального размера, происходит одно из следующих действий:

  • Если в журнале меньше минимального количества контейнеров, указанного политикой минимального размера, журнал расширяется до указанного в политике минимального количества контейнеров.
  • Если число контейнеров в журнале больше или равно минимальному числу контейнеров, заданному политикой минимального размера, изменения не вносятся, и вызов функции завершается без ошибок.

Дополнительные сведения см. в разделе InstallLogPolicy.
1
 Недопустимое значение; вызов функции завершается сбоем с ERROR_INVALID_PARAMETER.
2–1023
 Требуемый размер журнала, выраженный в виде количества контейнеров.

Если это число меньше минимального числа контейнеров, указанного установленной политикой, вызов функции завершается сбоем с ERROR_COULD_NOT_RESIZE_LOG.

Если это число больше, чем максимальное число контейнеров, указанное установленной политикой, журнал расширяется только до максимального числа контейнеров, указанного политикой, и функция завершается без ошибок.
1024–MAXULONGLONG
 Если политика максимального размера не установлена, вызов функции завершается сбоем с ERROR_LOG_POLICY_CONFLICT.

Если установлена политика максимального размера, журнал расширяется до максимального количества контейнеров, указанного политикой максимального размера, и функция завершается успешно без ошибок.

[out] pResultingSize

Указатель на допустимую переменную данных ULONGLONG получает количество контейнеров в журнале с измененными размерами после успешного выполнения.

Возвращаемое значение

Если функция выполняется успешно, возвращается ненулевое значение.

Если функция выполняется неудачно, возвращается нулевое значение. Чтобы получить расширенные сведения об ошибке, вызовите функцию GetLastError .

Комментарии

Контейнеры создаются с использованием того же атрибута безопасности, что и BLF-файл, и создаются в контексте приложения, а не в контексте владельца BLF-файла. Дополнительные сведения о BLF-файлах см. в разделе Типы журналов. Если контейнеры удаляются, они удаляются с помощью контекста безопасности вызывающего приложения.

Примеры

Пример использования этой функции см. в разделе Создание файла журнала.

Требования

   
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2003 R2 [только классические приложения]
Целевая платформа Windows
Header clfsmgmtw32.h
Библиотека Clfsw32.lib
DLL Clfsw32.dll

См. также раздел

Создание файла журнала

InstallLogPolicy

Типы журналов