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

  • Статья

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