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


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

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