структура 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 домена; например, контроллер домена не является контроллером домена Windows 2000.

DomainName

Указатель на строку с пустым завершением, указывающую имя домена. При наличии возвращается имя в стиле DNS, например "fabrikam.com". В противном случае возвращается имя в плоском стиле, например fabrikam. Это имя может отличаться от запрошенного доменного имени, если домен был переименован.

DnsForestName

Указатель на строку с пустым завершением, указывающую имя домена в корне дерева DS. При наличии возвращается имя в стиле DNS, например "fabrikam.com". В противном случае возвращается имя в плоском стиле, например fabrikam.

Flags

Содержит набор флагов, описывающих контроллер домена. Это может быть ноль или сочетание одного или нескольких из следующих значений.

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, которая указывает имя сайта, к которому принадлежит компьютер. Компьютер указывается в параметре ComputerName , переданном в DsGetDcName. Этот элемент может иметь значение NULL , если не удается найти сайт, содержащий компьютер; например, если администратор ds не связыл подсеть, в которую находится компьютер, с допустимым сайтом.

Комментарии

Примечание

Заголовок dsgetdc.h определяет DOMAIN_CONTROLLER_INFO в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора UNICODE. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
Верхняя часть	dsgetdc.h

См. также раздел

Структуры служб каталогов

DsGetDcName