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

Статья
08/08/2023

Подпрограмма 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 , представляющую журнал CLFS, или поток в журнале, в который добавляются или удаляются контейнеры. Значение этого параметра получается путем вызова подпрограммы ClfsCreateLogFile .

[in, optional] ClientCookie

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

[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

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