다음을 통해 공유

DOMAIN_CONTROLLER_INFOA 구조체(dsgetdc.h)

  • 아티클

DOMAIN_CONTROLLER_INFO 구조는 DsGetDcName 함수와 함께 도메인 컨트롤러에 대한 데이터를 수신하는 데 사용됩니다.

구문

typedef struct _DOMAIN_CONTROLLER_INFOA {
  LPSTR DomainControllerName;
  LPSTR DomainControllerAddress;
  ULONG DomainControllerAddressType;
  GUID  DomainGuid;
  LPSTR DomainName;
  LPSTR DnsForestName;
  ULONG Flags;
  LPSTR DcSiteName;
  LPSTR ClientSiteName;
} DOMAIN_CONTROLLER_INFOA, *PDOMAIN_CONTROLLER_INFOA;

멤버

DomainControllerName

검색된 도메인 컨트롤러의 컴퓨터 이름을 지정하는 null로 끝나는 문자열에 대한 포인터입니다. 반환된 컴퓨터 이름은 접두사로 "\"입니다. DNS 스타일 이름(예: "\phoenix.fabrikam.com")이 반환됩니다(사용 가능한 경우). DNS 스타일 이름을 사용할 수 없는 경우 플랫 스타일 이름(예: "\phoenix")이 반환됩니다. 이 예제는 도메인이 Windows NT 4.0 도메인이거나 도메인이 프로토콜의 IP 제품군을 지원하지 않는 경우에 적용됩니다.

DomainControllerAddress

검색된 도메인 컨트롤러의 주소를 지정하는 null로 끝나는 문자열에 대한 포인터입니다. 주소 앞에 "\"가 수록되어 있습니다. 이 문자열은 DomainControllerAddressType 멤버에 의해 정의된 형식 중 하나입니다.

DomainControllerAddressType

DomainControllerAddress 멤버에 포함된 문자열의 형식을 나타냅니다. 다음 값 중 하나일 수 있습니다.

DS_INET_ADDRESS

주소는 도메인 컨트롤러의 문자열 IP 주소(예: "\157.55.94.74")입니다.

DS_NETBIOS_ADDRESS

주소는 도메인 컨트롤러의 NetBIOS 이름(예: "\phoenix")입니다.

DomainGuid

도메인의 GUID 입니다. 도메인 컨트롤러에 도메인 GUID가 없는 경우 이 멤버는 0입니다. 예를 들어 도메인 컨트롤러는 Windows 2000 도메인 컨트롤러가 아닙니다.

DomainName

도메인의 이름을 지정하는 null로 끝나는 문자열에 대한 포인터입니다. DNS 스타일 이름(예: "fabrikam.com")은 사용 가능한 경우 반환됩니다. 그렇지 않으면 플랫 스타일 이름(예: "fabrikam")이 반환됩니다. 도메인 이름이 변경된 경우 이 이름은 요청된 도메인 이름과 다를 수 있습니다.

DnsForestName

DS 트리의 루트에 있는 도메인의 이름을 지정하는 null로 끝나는 문자열에 대한 포인터입니다. DNS 스타일 이름(예: "fabrikam.com")은 사용 가능한 경우 반환됩니다. 그렇지 않으면 플랫 스타일 이름(예: "fabrikam")이 반환됩니다.

Flags

도메인 컨트롤러를 설명하는 플래그 집합을 포함합니다. 이 값은 0이거나 다음 값 중 하나 이상의 조합일 수 있습니다.

DS_DNS_CONTROLLER_FLAG

DomainControllerName 멤버는 DNS 형식입니다.

DS_DNS_DOMAIN_FLAG

DomainName 멤버는 DNS 형식입니다.

DS_DNS_FOREST_FLAG

DnsForestName 멤버는 DNS 형식입니다.

DS_CLOSEST_FLAG

도메인 컨트롤러는 클라이언트와 동일한 사이트에 있습니다.

DS_DS_FLAG

도메인 컨트롤러는 도메인에 대한 디렉터리 서비스 서버입니다.

DS_FULL_SECRET_DOMAIN_6_FLAG

도메인 컨트롤러는 Windows 2008 이상 쓰기 가능한 도메인 컨트롤러입니다.

DS_GOOD_TIMESERV_FLAG

도메인 컨트롤러가 도메인에 대해 신뢰할 수 있는 Windows 시간 서비스를 실행하고 있습니다.

DS_GC_FLAG

도메인 컨트롤러는 DnsForestName으로 지정된 포리스트에 대한 글로벌 카탈로그 서버입니다.

DS_KDC_FLAG

도메인 컨트롤러는 도메인에 대한 Kerberos 키 배포 센터입니다.

DS_LDAP_FLAG

서버는 LDAP 서버입니다.

DS_NDNC_FLAG

도메인 이름은 애플리케이션(비 도메인) 명명 컨텍스트입니다.

DS_PDC_FLAG

도메인 컨트롤러는 도메인의 기본 도메인 컨트롤러입니다.

DS_SELECT_SECRET_DOMAIN_6_FLAG

도메인 컨트롤러는 Windows 2008 이상 읽기 전용 도메인 컨트롤러입니다.

DS_TIMESERV_FLAG

도메인 컨트롤러가 도메인에 대한 Windows 시간 서비스를 실행하고 있습니다.

DS_WRITABLE_FLAG

도메인 컨트롤러는 쓰기 가능한 디렉터리 서비스(또는 SAM)를 호스트합니다.

DcSiteName

도메인 컨트롤러가 있는 사이트의 이름을 지정하는 null로 끝나는 문자열에 대한 포인터입니다. 도메인 컨트롤러가 사이트에 없는 경우 이 멤버는 NULL일 수 있습니다. 예를 들어 도메인 컨트롤러는 Windows NT 4.0 도메인 컨트롤러입니다.

ClientSiteName

컴퓨터가 속한 사이트의 이름을 지정하는 null로 끝나는 문자열에 대한 포인터입니다. 컴퓨터는 DsGetDcName에 전달된 ComputerName 매개 변수에 지정됩니다. 컴퓨터를 포함하는 사이트를 찾을 수 없는 경우 이 멤버는 NULL 일 수 있습니다. 예를 들어 DS 관리자가 컴퓨터가 있는 서브넷을 유효한 사이트와 연결하지 않은 경우입니다.

설명

참고

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

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows Vista
지원되는 최소 서버 Windows Server 2008
머리글 dsgetdc.h

추가 정보

디렉터리 서비스 구조

DsGetDcName