LsaSetForestTrustInformation 함수(ntsecapi.h)

LsaSetForestTrustInformation 함수는 지정된 로컬 보안 기관TrustedDomain 개체에 대한 포리스트 트러스트 정보를 설정합니다.

구문

NTSTATUS LsaSetForestTrustInformation(
  [in]  LSA_HANDLE                              PolicyHandle,
  [in]  PLSA_UNICODE_STRING                     TrustedDomainName,
  [in]  PLSA_FOREST_TRUST_INFORMATION           ForestTrustInfo,
  [in]  BOOLEAN                                 CheckOnly,
  [out] PLSA_FOREST_TRUST_COLLISION_INFORMATION *CollisionInfo
);

매개 변수

[in] PolicyHandle

시스템의 Policy 개체에 대한 핸들입니다.

[in] TrustedDomainName

ForestTrustInfo 매개 변수로 지정된 포리스트 트러스트 정보를 설정할 TrustedDomain 개체의 이름을 포함하는 LSA_UNICODE_STRING 구조체에 대한 포인터입니다.

[in] ForestTrustInfo

TrustedDomainName 매개 변수로 지정된 TrustedDomain 개체로 설정할 포리스트 트러스트 정보가 포함된 LSA_FOREST_TRUST_INFORMATION 구조체에 대한 포인터입니다.

[in] CheckOnly

TrustedDomain 개체의 변경 내용이 유지되는지 여부를 지정하는 부울 값입니다. 이 값이 TRUE이면 이 함수는 지정된 매개 변수와의 충돌을 검사 ForestTrustInfo 매개 변수로 지정된 포리스트 트러스트 정보를 TrustedDomainName 매개 변수로 지정된 TrustedDomain 개체로 설정하지 않습니다. 이 값이 FALSE이면 포리스트 트러스트 정보가 TrustedDomain 개체로 설정됩니다.

[out] CollisionInfo

발생한 충돌에 대한 정보를 반환하는 LSA_FOREST_TRUST_COLLISION_INFORMATION 구조체에 대한 포인터입니다.

반환 값

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

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

반환 코드/값	설명
STATUS_INVALID_DOMAIN_STATE	이 작업은 루트 도메인의 도메인 컨트롤러에서만 사용할 수 있습니다.
STATUS_INVALID_DOMAIN_ROLE	작업은 주 도메인 컨트롤러에서만 사용할 수 있습니다.

요구 사항

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