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

Статья
02/29/2024

Подпрограмма ClfsMgmtInstallPolicy добавляет структуру CLFS_MGMT_POLICY в физический журнал.

Синтаксис

CLFSUSER_API NTSTATUS ClfsMgmtInstallPolicy(
  [in] PLOG_FILE_OBJECT  LogFile,
  [in] PCLFS_MGMT_POLICY Policy,
  [in] ULONG             PolicyLength
);

Параметры

[in] LogFile

Указатель на структуру LOG_FILE_OBJECT , представляющую журнал CLFS, к которому будет применяться данный экземпляр структуры CLFS_MGMT_POLICY . Политика применяется ко всем потокам в журнале, даже если указан один поток в журнале.

[in] Policy

Указатель на структуру CLFS_MGMT_POLICY , содержащую устанавливаемую политику.

[in] PolicyLength

Длина (в байтах) структуры, на которую указывает параметр Policy .

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

Подпрограмма ClfsMgmtInstallPolicy возвращает одно из следующих значений NTSTATUS:

Код возврата	Описание
STATUS_SUCCESS	Политика установлена.
STATUS_INVALID_PARAMETER_1	Для параметра LogFile было указано значение NULL.
STATUS_INVALID_PARAMETER_2	Для параметра Policy было указано значение NULL.
STATUS_INVALID_PARAMETER_3	Значение параметра PolicyLength меньше размера экземпляра структуры CLFS_MGMT_POLICY .
STATUS_NOT_SUPPORTED	Элемент PolicyFlagsCLFS_MGMT_POLICY_STRUCTURE , на который указывает параметр Policy , указывает любой флаг, отличный от LOG_POLICY_OVERWRITE.
STATUS_INVALID_PARAMETER	Верно любое из условий ниже. Элемент Version параметра Policy не равен CLFS_MGMT_POLICY_VERSION. Значение параметра Policy равно ClfsMgmtPolicyInvalid. Элемент PolicyFlags параметра Policy указывает любой флаг, отличный от LOG_POLICY_OVERWRITE.
STATUS_LOG_POLICY_ALREADY_INSTALLED	В журнале уже есть политика этого типа, и флаг LOG_POLICY_OVERWRITE не установлен.
STATUS_INSUFFICIENT_RESOURCES	Недостаточно памяти для завершения операции.

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

Политики являются нестабильными. При закрытии всех дескрипторов журнала политики будут потеряны. Политики следует устанавливать при каждой регистрации первого клиента.

Перед созданием первого контейнера в журнале следует зарегистрировать только CLFS_MGMT_POLICY структуру , член PolicyType которой равен ClfsMgmtPolicyNewContainerSize . Все последующие регистрации игнорируются.

Установленная политика журнала применяется к физическому журналу, даже если параметр LogFile указывает поток журнала.

Требования

Требование	Значение
Минимальная версия клиента	Доступно в Windows Server 2003 R2, Windows Vista и более поздних версиях Windows.
Целевая платформа	Персональный компьютер
Верхняя часть	wdm.h (включая Wdm.h, Ntddk.h, Ntifs.h)
Библиотека	Clfs.lib
DLL	Clfs.sys
IRQL	<= APC_LEVEL

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

CLFS_MGMT_POLICY

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