структура DOMAIN_CONTROLLER_INFOW (dsgetdc.h)

Статья
11/20/2024

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

DomainName

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

DnsForestName

Указатель на строку, завершающуюся значением NULL, которая указывает имя домена в корне дерева 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 или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows Vista
минимальный поддерживаемый сервер	Windows Server 2008
заголовка	dsgetdc.h

См. также

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

DsGetDcName

Поделиться через