Функция ClfsMgmtSetLogFileSizeAsClient (wdm.h)

Статья
02/07/2025

Программа ClfsMgmtSetLogFileSizeAsClient задает размер файла журнала, добавив контейнеры в журнал клиента или удалив контейнеры из журнала клиента.

Синтаксис

CLFSUSER_API NTSTATUS ClfsMgmtSetLogFileSizeAsClient(
  [in]            PLOG_FILE_OBJECT                     LogFile,
  [in, optional]  CLFS_MGMT_CLIENT                     ClientCookie,
  [in]            PULONGLONG                           NewSizeInContainers,
  [out, optional] PULONGLONG                           ResultingSizeInContainers,
  [in, optional]  PCLFS_SET_LOG_SIZE_COMPLETE_CALLBACK CompletionRoutine,
  [in, optional]  PVOID                                CompletionRoutineData
);

Параметры

[in] LogFile

Указатель на структуру LOG_FILE_OBJECT, представляющую журнал Common Log File System (CLFS) или поток в журнале, в который добавляются или удаляются контейнеры. Значение этого параметра получается с помощью вызова подпрограммы clfsCreateLogFile .

[in, optional] ClientCookie

Указатель на предоставленный клиентом файл cookie. Значение этого параметра должно быть CLFS_MGMT_CLIENT структурой, полученной с помощью вызова подпрограммы ClfsMgmtRegisterManagedCl ient.

[in] NewSizeInContainers

Требуемый размер журнала, выраженный в количестве контейнеров. Для файла журнала может быть не более 1024 контейнеров.

[out, optional] ResultingSizeInContainers

Фактический размер журнала, выраженный в количестве контейнеров.

[in, optional] CompletionRoutine

Не используется.

[in, optional] CompletionRoutineData

Не используется.

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

Подпрограмма clfsMgmtSetLogFileSizeAsClient возвращает значение NTSTATUS.

Возвращаемый код	Описание
STATUS_SUCCESS	Размер файла журнала установлен.
STATUS_INVALID_PARAMETER_1	Значение параметра logFile равно NULLили содержимое параметра NewSizeInContainers равно 1.
STATUS_INVALID_PARAMETER_2	Значение параметра NewSizeInContainers равно NULL.
STATUS_LOG_POLICY_INVALID	Установленный набор политик в журнале недопустим. Это может быть связано с недопустимой политикой ClfsMgmtPolicyAutoShrink или политикой ClfsMgmtPolicyMaximumSize.
STATUS_COULD_NOT_RESIZE_LOG	Управление CLFS не удалось удалить достаточно контейнеров, чтобы достичь значения в NewSizeInContainers.
STATUS_LOG_POLICY_CONFLICT	Политика в указанном журнале не позволила завершить операцию. Это может произойти, если управление CLFS не удалось добавить в журнал достаточно контейнеров, чтобы достичь значения в NewSizeInContainers. Это может быть связано с конфликтом с политикой, заданной клиентом.

Эта подпрограмма также может возвращать другие значения NTSTATUS.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Доступно в Windows 7 и более поздних версиях Windows.
целевая платформа	Настольный
заголовка	wdm.h
DLL	Clfs.sys

См. также

подпрограммы библиотеки управления CLFS

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