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

포리스트 트러스트 정보를 검색할 TrustedDomain 개체의 이름을 포함하는 LSA_UNICODE_STRING 구조체에 대한 포인터입니다.

[out] ForestTrustInfo

TrustedDomainName 매개 변수로 지정된 TrustedDomain 개체에 대한 포리스트 트러스트 정보를 반환하는 LSA_FOREST_TRUST_INFORMATION 구조체에 대한 포인터입니다.

반환 값

함수가 성공하면 반환 값이 STATUS_SUCCESS.

함수가 실패하면 반환 값은 다음 값 또는 LSA 정책 함수 반환 값 중 하나일 수 있는 NTSTATUS 코드입니다.

반환 코드/값	설명
STATUS_INVALID_DOMAIN_ROLE	작업은 주 도메인 컨트롤러에서만 사용할 수 있습니다.
STATUS_INVALID_DOMAIN_STATE	이 작업은 루트 도메인의 도메인 컨트롤러에서만 사용할 수 있습니다.
STATUS_NO_SUCH_DOMAIN	지정한 TrustedDomain 개체가 없습니다.
STATUS_NOT_FOUND	지정한 TrustedDomain 개체에 포리스트 트러스트 정보가 포함되어 있지 않습니다.

설명

이 함수에 대한 액세스는 보안 개체로 보호됩니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	지원되는 버전 없음
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	ntsecapi.h
라이브러리	Advapi32.lib
DLL	Advapi32.dll