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