DsEnumerateDomainTrustsA 함수(dsgetdc.h)

DsEnumerateDomainTrusts 함수는 지정된 도메인에 대한 도메인 신뢰 데이터를 가져옵니다.

구문

DSGETDCAPI DWORD DsEnumerateDomainTrustsA(
  [in, optional] LPSTR              ServerName,
  [in]           ULONG              Flags,
  [out]          PDS_DOMAIN_TRUSTSA *Domains,
  [out]          PULONG             DomainCount
);

매개 변수

[in, optional] ServerName

트러스트 정보를 가져올 도메인의 컴퓨터 이름을 지정하는 null로 끝나는 문자열에 대한 포인터입니다. 이 매개 변수가 NULL이면 로컬 컴퓨터의 이름이 사용됩니다. 호출자는 이 도메인에서 인증된 사용자여야 합니다.

이 컴퓨터가 도메인 컨트롤러인 경우 이 함수는 신뢰 데이터를 즉시 반환합니다. 이 컴퓨터가 도메인 컨트롤러가 아닌 경우 이 함수는 캐시된 데이터가 만료되지 않은 경우 캐시된 데이터에서 신뢰 데이터를 가져옵니다. 캐시된 데이터가 만료되면 이 함수는 이 컴퓨터가 구성원인 도메인 컨트롤러에서 트러스트 데이터를 가져오고 캐시를 업데이트합니다. 캐시된 데이터는 5분 후에 자동으로 만료됩니다.

[in] Flags

열거할 도메인 트러스트를 결정하는 플래그 집합을 포함합니다. 이 값은 0이거나 다음 값 중 하나 이상의 조합일 수 있습니다.

DS_DOMAIN_DIRECT_INBOUND

ServerName을 멤버로 사용하는 도메인을 직접 신뢰하는 도메인을 열거합니다.

DS_DOMAIN_DIRECT_OUTBOUND

ServerName을 멤버로 사용하는 도메인에서 직접 신뢰하는 도메인을 열거합니다.

DS_DOMAIN_IN_FOREST

ServerName을 멤버로 사용하는 동일한 포리스트의 멤버인 도메인을 열거합니다.

DS_DOMAIN_NATIVE_MODE

기본 도메인이 Windows 2000 기본 모드에서 실행되는 도메인을 열거합니다.

DS_DOMAIN_PRIMARY

ServerName을 멤버로 사용하는 도메인의 기본 도메인인 도메인을 열거합니다.

DS_DOMAIN_TREE_ROOT

ServerName을 멤버로 사용하는 포리스트의 루트에 있는 도메인을 열거합니다.

[out] Domains

DS_DOMAIN_TRUSTS 구조체의 배열을 수신하는 PDS_DOMAIN_TRUSTS 값에 대한 포인터입니다. 이 배열의 각 구조에는 도메인에 대한 신뢰 데이터가 포함됩니다. 호출자는 NetApiBufferFree를 호출하여 더 이상 필요하지 않은 경우 이 메모리를 해제해야 합니다.

[out] DomainCount

Domains 배열에서 반환된 요소 수를 받는 ULONG 값에 대한 포인터입니다.

반환 값

성공하면 ERROR_SUCCESS 반환하고, 그렇지 않으면 Win32 오류 코드를 반환합니다. 가능한 오류 코드에는 다음 목록에 나열된 오류 코드가 포함됩니다.

설명

참고

dsgetdc.h 헤더는 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 DsEnumerateDomainTrusts를 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.

요구 사항

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

추가 정보

DS_DOMAIN_TRUSTS

디렉터리 서비스 함수

NetApiBufferFree