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 오류 코드를 반환합니다. 가능한 오류 코드에는 다음 목록에 나열된 코드가 포함됩니다.

발언

요구 사항

참고 항목

DS_DOMAIN_TRUSTS

디렉터리 서비스 함수

NetApiBufferFree