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

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

Замечания

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

Требования

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