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

Статья
08/25/2023

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

Синтаксис

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

Параметры

[in] PolicyHandle

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

[in] TrustedDomainSid

Указатель на идентификатор безопасности доверенного домена для запроса.

[in] InformationClass

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

Значение	Значение
TrustedDomainNameInformation	Извлекает имя доверенного домена. Параметр Buffer получает указатель на структуру TRUSTED_DOMAIN_NAME_INFO .
TrustedPosixOffsetInformation	Извлекает значение, используемое для создания идентификаторов пользователей и групп Posix для доверенного домена. Параметр Buffer получает указатель на структуру TRUSTED_POSIX_OFFSET_INFO .
TrustedPasswordInformation	Извлекает пароль для доверенного домена. Параметр Buffer получает указатель на структуру TRUSTED_PASSWORD_INFO . Дескриптор, переданный в параметре PolicyHandle , должен иметь право доступа POLICY_GET_PRIVATE_INFORMATION.
TrustedDomainInformationEx	Извлекает расширенные сведения о доверенном домене. Параметр Buffer получает указатель на структуру TRUSTED_DOMAIN_INFORMATION_EX .
TrustedDomainInformationBasic	Это значение не поддерживается.
TrustedDomainFullInformation	Извлекает полную информацию о доверенном домене. Эти сведения включают сведения о смещении Posix, сведения о проверке подлинности и расширенные сведения, возвращаемые для значения TrustedDomainInformationEx. Параметр Buffer получает указатель на структуру TRUSTED_DOMAIN_FULL_INFORMATION .

[out] Buffer

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

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

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

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

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

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

Требования

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