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

Статья
03/05/2024

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

Синтаксис

NTSTATUS LsaSetTrustedDomainInformation(
  [in] LSA_HANDLE                PolicyHandle,
  [in] PSID                      TrustedDomainSid,
  [in] TRUSTED_INFORMATION_CLASS InformationClass,
  [in] PVOID                     Buffer
);

Параметры

[in] PolicyHandle

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

[in] TrustedDomainSid

Указатель на идентификатор безопасности доверенного домена, сведения которого изменяются. Если для параметра InformationClass задано значение TrustedDomainNameInformation, этот параметр должен указывать на идентификатор безопасности домена, добавляемого в список доверенных доменов.

[in] InformationClass

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

Значение	Значение
TrustedDomainNameInformation	Если указанный домен отсутствует в списке доверенных доменов, функция LsaSetTrustedDomainInformation добавляет его. Параметр TrustedDomainSid должен быть идентификатором безопасности добавляемого домена. Параметр Buffer должен быть указателем на структуру TRUSTED_DOMAIN_NAME_INFO , содержащую имя добавляемого домена. Если указанный домен уже включен в список доверенных доменов, функция завершается сбоем.
TrustedPosixOffsetInformation	Задает значение, используемое для создания идентификаторов пользователей и групп Posix. Параметр Buffer должен быть указателем на структуру TRUSTED_POSIX_OFFSET_INFO .
TrustedPasswordInformation	Задает пароль для доверенного домена. Параметр Buffer должен быть указателем на структуру TRUSTED_PASSWORD_INFO , содержащую старый и новый пароли для указанного домена. Дескриптор, переданный в параметре PolicyHandle , должен иметь право доступа POLICY_CREATE_SECRET. Старая строка пароля может иметь значение NULL.

[in] Buffer

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

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

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

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

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

Требования

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

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

LsaDeleteTrustedDomain

LsaQueryTrustedDomainInfo

TRUSTED_DOMAIN_NAME_INFO

TRUSTED_INFORMATION_CLASS

TRUSTED_PASSWORD_INFO

TRUSTED_POSIX_OFFSET_INFO

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