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

Статья
03/15/2023

Функция LsaOpenTrustedDomainByName открывает дескриптор политики LSA удаленного доверенного домена. Этот дескриптор можно передать в вызовы функций LSA, чтобы задать политику LSA удаленного компьютера или запросить ее.

Синтаксис

NTSTATUS LsaOpenTrustedDomainByName(
  [in]  LSA_HANDLE          PolicyHandle,
  [in]  PLSA_UNICODE_STRING TrustedDomainName,
  [in]  ACCESS_MASK         DesiredAccess,
  [out] PLSA_HANDLE         TrustedDomainHandle
);

Параметры

[in] PolicyHandle

Дескриптор объекта Policy . Это дескриптор политики локального компьютера. Дополнительные сведения см. в разделе Открытие дескриптора объекта политики.

[in] TrustedDomainName

Имя доверенного домена. Это может быть неструктурированное имя или dns-имя домена.

[in] DesiredAccess

Структура ACCESS_MASK , указывающая разрешения на доступ, запрашиваемые для объекта удаленного доверенного домена.

[out] TrustedDomainHandle

Указатель, получающий адрес дескриптора политики LSA удаленного доверенного домена. Этот дескриптор можно передать в вызовы функций LSA, чтобы запрашивать политику LSA удаленного компьютера и управлять ею.

Если приложению больше не нужен этот дескриптор, оно должно вызвать LsaClose , чтобы удалить дескриптор.

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

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

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

Значение	Описание
STATUS_ACCESS_DENIED	Вызывающий объект не имеет соответствующего доступа для завершения операции.
STATUS_OBJECT_NAME_NOT_FOUND	В базе данных LSA целевой системы нет объекта доверенного домена с указанным именем.

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

Требования

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

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

LsaClose

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