DOMAIN_CONTROLLER_INFOW 구조체(dsgetdc.h)
DOMAIN_CONTROLLER_INFO 구조는 DsGetDcName 함수와 함께 도메인 컨트롤러에 대한 데이터를 수신하는 데 사용됩니다.
구문
typedef struct _DOMAIN_CONTROLLER_INFOW {
#if ...
wchar_t *DomainControllerName;
#else
LPWSTR DomainControllerName;
#endif
#if ...
wchar_t *DomainControllerAddress;
#else
LPWSTR DomainControllerAddress;
#endif
ULONG DomainControllerAddressType;
GUID DomainGuid;
#if ...
wchar_t *DomainName;
#else
LPWSTR DomainName;
#endif
#if ...
wchar_t *DnsForestName;
#else
LPWSTR DnsForestName;
#endif
ULONG Flags;
#if ...
wchar_t *DcSiteName;
#else
LPWSTR DcSiteName;
#endif
#if ...
wchar_t *ClientSiteName;
#else
LPWSTR ClientSiteName;
#endif
} DOMAIN_CONTROLLER_INFOW, *PDOMAIN_CONTROLLER_INFOW;
멤버
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 헤더는 DOMAIN_CONTROLLER_INFO 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.
요구 사항
| 지원되는 최소 클라이언트 | Windows Vista |
| 지원되는 최소 서버 | Windows Server 2008 |
| 머리글 | dsgetdc.h |