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

  • Статья

Функция LsaQueryForestTrustInformation извлекает сведения о доверии леса для указанного объекта TrustedDomainлокального центра безопасности.

Синтаксис

NTSTATUS LsaQueryForestTrustInformation(
  [in]  LSA_HANDLE                    PolicyHandle,
  [in]  PLSA_UNICODE_STRING           TrustedDomainName,
  [out] PLSA_FOREST_TRUST_INFORMATION *ForestTrustInfo
);

Параметры

[in] PolicyHandle

Дескриптор объекта Policy для системы.

[in] TrustedDomainName

Указатель на структуру LSA_UNICODE_STRING , содержащую имя объекта TrustedDomain , для которого требуется получить сведения о доверии леса.

[out] ForestTrustInfo

Указатель на структуру LSA_FOREST_TRUST_INFORMATION , которая возвращает сведения о доверии леса для объекта TrustedDomain , заданного параметром TrustedDomainName .

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

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

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

Возвращаемый код или значение Описание
STATUS_INVALID_DOMAIN_ROLE
 Операция является законной только на основном контроллере домена.
STATUS_INVALID_DOMAIN_STATE
 Операция является законной только на контроллерах домена в корневом домене.
STATUS_NO_SUCH_DOMAIN
 Указанный объект TrustedDomain не существует.
STATUS_NOT_FOUND
 Указанный объект TrustedDomain не содержит сведений о доверии леса.

Комментарии

Доступ к этой функции защищен защищаемым объектом.

Требования

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