DsGetForestTrustInformationW 함수(dsgetdc.h)
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 |