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

Статья
08/22/2023

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

Синтаксис

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

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

Поделиться через