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


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

Функция 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

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

LsaFreeMemory

LsaSetInformationPolicy

POLICY_ACCOUNT_DOMAIN_INFO

POLICY_AUDIT_EVENTS_INFO

POLICY_DNS_DOMAIN_INFO

POLICY_INFORMATION_CLASS

POLICY_LSA_SERVER_ROLE_INFO

POLICY_MODIFICATION_INFO

POLICY_PRIMARY_DOMAIN_INFO