DsGetForestTrustInformationW 함수(dsgetdc.h)

아티클
08/23/2023

DsGetForestTrustInformationW 함수는 지정된 도메인에 대한 포리스트 트러스트 데이터를 가져옵니다.

구문

DSGETDCAPI DWORD DsGetForestTrustInformationW(
  [in, optional] LPCWSTR                       ServerName,
  [in, optional] LPCWSTR                       TrustedDomainName,
  [in]           DWORD                         Flags,
  [out]          PLSA_FOREST_TRUST_INFORMATION *ForestTrustInfo
);

매개 변수

[in, optional] ServerName

DsGetForestTrustInformationW가 원격으로 연결된 도메인 컨트롤러의 이름을 포함합니다. 호출자는 이 서버에서 인증된 사용자여야 합니다. 이 매개 변수가 NULL이면 로컬 서버가 사용됩니다.

[in, optional] TrustedDomainName

포리스트 트러스트 데이터를 검색할 신뢰할 수 있는 도메인의 NETBIOS 또는 DNS 이름을 포함합니다. 이 도메인에는 TRUST_ATTRIBUTE_FOREST_TRANSITIVE 트러스트 특성이 있어야 합니다. 자세한 내용은 TRUSTED_DOMAIN_INFORMATION_EX 참조하세요.

이 매개 변수가 NULL이면 ServerName 에서 호스트하는 도메인에 대한 포리스트 트러스트 데이터가 검색됩니다.

[in] Flags

이 함수의 동작을 수정하는 플래그 집합을 포함합니다. 이 값은 0 또는 다음 값일 수 있습니다.

DS_GFTI_UPDATE_TDO

이 플래그가 설정되면 DsGetForestTrustInformationW 는 TrustedDomainName 매개 변수로 식별된 신뢰할 수 있는 도메인의 포리스트 트러스트 데이터를 업데이트합니다. 이 경우 TrustedDomainName 매개 변수는 NULL일 수 없습니다. 호출자는 트러스트 데이터를 수정하거나 ERROR_ACCESS_DENIED 반환할 수 있는 액세스 권한이 있어야 합니다.

이 플래그는 ServerName 이 도메인의 기본 도메인 컨트롤러를 지정하는 경우에만 유효합니다.

[out] ForestTrustInfo

TrustedDomainName에서 지정한 도메인에서 클레임하는 네임스페이스를 설명하는 포리스트 트러스트 데이터를 수신하는 LSA_FOREST_TRUST_INFORMATION 구조체 포인터에 대한 포인터입니다. 반환된 모든 레코드의 시간 멤버는 0입니다.

호출자는 NetApiBufferFree를 호출하여 더 이상 필요하지 않은 경우 이 구조를 해제해야 합니다.

반환 값

성공하면 NO_ERROR 반환하거나 Win32 오류 코드를 반환합니다. 가능한 오류 코드에는 다음이 포함됩니다.

요구 사항


지원되는 최소 클라이언트	Windows Vista
지원되는 최소 서버	Windows Server 2008
대상 플랫폼	Windows
헤더	dsgetdc.h
라이브러리	Netapi32.lib
DLL	Netapi32.dll

추가 정보

디렉터리 서비스 함수

NetApiBufferFree

TRUSTED_DOMAIN_INFORMATION_EX

다음을 통해 공유