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

Статья
02/07/2025

Подпрограмма clfsMgmtQueryPolicy получает определенную структуру CLFS_MGMT_POLICY для журнала.

Синтаксис

CLFSUSER_API NTSTATUS ClfsMgmtQueryPolicy(
  [in]  PLOG_FILE_OBJECT      LogFile,
  [in]  CLFS_MGMT_POLICY_TYPE PolicyType,
  [out] PCLFS_MGMT_POLICY     Policy,
  [out] PULONG                PolicyLength
);

Параметры

[in] LogFile

Указатель на структуру LOG_FILE_OBJECT, представляющую журнал CLFS, политика которого извлекается.

[in] PolicyType

Значение перечисления CLFS_MGMT_POLICY_TYPE, определяющего тип политики, который требуется извлечь.

[out] Policy

Экземпляр структуры CLFS_MGMT_POLICY, содержащей политику.

[out] PolicyLength

Длина параметра политики.

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

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

Возвращаемый код	Описание
STATUS_SUCCESS	Управление CLFS извлекло запрошенную политику.
STATUS_UNSUCCESSFUL	Управление CLFS не удалось обработать запрос.
STATUS_INVALID_PARAMETER	Значение параметра PolicyType недопустимо для перечисления CLFS_MGMT_POLICY_TYPE.
STATUS_INVALID_PARAMETER_1	Значение NULL было предоставлено для параметра LogFile.
STATUS_INVALID_PARAMETER_2	Значение параметра PolicyLength меньше размера экземпляра структуры CLFS_MGMT_POLICY.
STATUS_INSUFFICIENT_RESOURCES	Для завершения операции недостаточно памяти.
STATUS_LOG_POLICY_NOT_INSTALLED	Политика этого типа не зарегистрирована для файла журнала.

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

Требования

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

См. также

CLFS_MGMT_POLICY

CLFS_MGMT_POLICY_TYPE

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