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

Статья
03/05/2024

Функция LsaSetInformationPolicy изменяет сведения в объекте Policy .

Синтаксис

NTSTATUS LsaSetInformationPolicy(
  [in] LSA_HANDLE               PolicyHandle,
  [in] POLICY_INFORMATION_CLASS InformationClass,
  [in] PVOID                    Buffer
);

Параметры

[in] PolicyHandle

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

[in] InformationClass

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

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

[in] Buffer

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

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

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

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

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

Требования

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

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

POLICY_ACCOUNT_DOMAIN_INFO

POLICY_AUDIT_EVENTS_INFO

POLICY_DNS_DOMAIN_INFO

POLICY_LSA_SERVER_ROLE_INFO

POLICY_PRIMARY_DOMAIN_INFO

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