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

  • Статья

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

Синтаксис

CLFSUSER_API NTSTATUS ClfsMgmtSetLogFileSizeAsClient(
  [in]            PLOG_FILE_OBJECT                     LogFile,
  [in, optional]  PCLFS_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