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

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

  • Статья

Подпрограмма 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