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

Статья
08/25/2023

Функция LsaQueryTrustedDomainInfoByName возвращает сведения о доверенном домене.

Синтаксис

NTSTATUS LsaQueryTrustedDomainInfoByName(
  [in]  LSA_HANDLE                PolicyHandle,
  [in]  PLSA_UNICODE_STRING       TrustedDomainName,
  [in]  TRUSTED_INFORMATION_CLASS InformationClass,
  [out] PVOID                     *Buffer
);

Параметры

[in] PolicyHandle

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

[in] TrustedDomainName

Строка, содержащая имя доверенного домена. Это может быть доменное имя или неструктурированное имя.

[in] InformationClass

Указывает тип извлекаемой информации. Этот параметр может принимать одно из указанных ниже значений.

Значение	Значение
TrustedDomainNameInformation	Имя доверенного домена.
TrustedPosixInformation	Смещение posix доверенного домена.
TrustedPasswordInformation	Возвращает пароль на исходящей стороне доверия.
TrustedDomainInformationBasic	Это значение не поддерживается.
TrustedDomainInformationEx	Сведения о расширенном доверии, включая основные сведения и доменное имя DNS, а также атрибуты о доверии.
TrustedDomainFullInformation	Полные сведения, включая смещение Posix и сведения о проверке подлинности.

[out] Buffer

Получает указатель на возвращенный буфер, содержащий запрошенные сведения. Формат и содержимое этого буфера зависят от класса информации. Например, если параметру InformationClass присвоено значение TrustedDomainInformationEx, буфер получает указатель на TRUSTED_DOMAIN_INFORMATION_EX структуру. Дополнительные сведения см. в разделе TRUSTED_INFORMATION_CLASS.

Завершив использование буфера, освободите его, вызвав функцию LsaFreeMemory .

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

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

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

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

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

Требования

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

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

LsaFreeMemory

LsaQueryTrustedDomainInfo

LsaSetTrustedDomainInfoByName

TRUSTED_DOMAIN_INFORMATION_EX

TRUSTED_INFORMATION_CLASS

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