Функция LsaQueryInformationPolicy (ntsecapi.h)

Статья
08/25/2023

Функция LsaQueryInformationPolicy извлекает сведения об объекте Policy .

Синтаксис

NTSTATUS LsaQueryInformationPolicy(
  [in]  LSA_HANDLE               PolicyHandle,
  [in]  POLICY_INFORMATION_CLASS InformationClass,
  [out] PVOID                    *Buffer
);

Параметры

[in] PolicyHandle

Дескриптор объекта Policy . Необходимые права доступа для этого дескриптора зависят от значения параметра InformationClass . Дополнительные сведения см. в разделе Открытие дескриптора объекта политики.

[in] InformationClass

Задает одно из следующих значений из типа перечисления POLICY_INFORMATION_CLASS . Значение указывает тип извлекаемой информации.

Значение	Значение
PolicyAuditEventsInformation	Извлекает правила аудита системы. Дескриптор, передаваемый в параметре PolicyHandle , должен иметь право доступа POLICY_VIEW_AUDIT_INFORMATION. Параметр Buffer получает указатель на структуру POLICY_AUDIT_EVENTS_INFO .
PolicyPrimaryDomainInformation	Извлекает имя и идентификатор безопасности основного домена системы. Дескриптор, переданный в параметре PolicyHandle , должен иметь право доступа POLICY_VIEW_LOCAL_INFORMATION. Параметр Buffer получает указатель на структуру POLICY_PRIMARY_DOMAIN_INFO .
PolicyAccountDomainInformation	Извлекает имя и идентификатор безопасности домена учетной записи системы. Дескриптор, переданный в параметре PolicyHandle , должен иметь право доступа POLICY_VIEW_LOCAL_INFORMATION. Параметр Buffer получает указатель на структуру POLICY_ACCOUNT_DOMAIN_INFO .
PolicyLsaServerRoleInformation	Извлекает роль сервера LSA. Дескриптор, переданный в параметре PolicyHandle , должен иметь право доступа POLICY_VIEW_LOCAL_INFORMATION. Параметр Buffer получает указатель на структуру POLICY_LSA_SERVER_ROLE_INFO .
PolicyModificationInformation	Извлекает сведения о времени создания и последнем изменении базы данных LSA. Дескриптор, переданный в параметре PolicyHandle , должен иметь право доступа POLICY_VIEW_LOCAL_INFORMATION. Параметр Buffer получает указатель на структуру POLICY_MODIFICATION_INFO .
PolicyDnsDomainInformation	Извлекает сведения о системе доменных имен (DNS) о основном домене, связанном с объектом Policy . Дескриптор, переданный в параметре PolicyHandle , должен иметь право доступа POLICY_VIEW_LOCAL_INFORMATION. Параметр Buffer получает указатель на структуру POLICY_DNS_DOMAIN_INFO .

[out] Buffer

Указатель на переменную, которая получает указатель на структуру, содержащую запрошенные сведения. Тип структуры зависит от значения параметра InformationClass .

Если сведения больше не нужны, передайте возвращенный указатель в LsaFreeMemory.

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

Если функция LsaQueryInformationPolicy завершается успешно, возвращаемое значение будет STATUS_SUCCESS.

Если функция завершается сбоем, возвращаемым значением будет код NTSTATUS. Дополнительные сведения см. в разделе Возвращаемые значения функции политики LSA.

Для преобразования кода NTSTATUS в код ошибки Windows можно использовать функцию LsaNtStatusToWinError .

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	ntsecapi.h
Библиотека	Advapi32.lib
DLL	Advapi32.dll