структура DS_DOMAIN_CONTROLLER_INFO_1A (ntdsapi.h)

Статья
11/20/2024

Структура DS_DOMAIN_CONTROLLER_INFO_1 содержит данные о контроллере домена. Эта структура возвращается функцией DsGetDomainControllerInfo.

Синтаксис

typedef struct {
#if ...
  CHAR  *NetbiosName;
#if ...
  CHAR  *DnsHostName;
#if ...
  CHAR  *SiteName;
#if ...
  CHAR  *ComputerObjectName;
#if ...
  CHAR  *ServerObjectName;
#else
  LPSTR NetbiosName;
#endif
#else
  LPSTR DnsHostName;
#endif
#else
  LPSTR SiteName;
#endif
#else
  LPSTR ComputerObjectName;
#endif
#else
  LPSTR ServerObjectName;
#endif
  BOOL  fIsPdc;
  BOOL  fDsEnabled;
} DS_DOMAIN_CONTROLLER_INFO_1A, *PDS_DOMAIN_CONTROLLER_INFO_1A;

Члены

NetbiosName

Указатель на строку, завершающую значение NULL, которая указывает имя NetBIOS контроллера домена.

DnsHostName

Указатель на строку, завершающуюся значением NULL, которая указывает dns-имя узла контроллера домена.

SiteName

Указатель на строку, завершающуюся значением NULL, которая указывает сайт, к которому принадлежит контроллер домена.

ComputerObjectName

Указатель на строку, завершающую значение NULL, которая указывает имя объекта компьютера на контроллере домена.

ServerObjectName

Указатель на строку, завершающую значение NULL, которая указывает имя объекта сервера на контроллере домена.

fIsPdc

Логическое значение, указывающее, является ли этот контроллер домена основным контроллером домена. Если это значение TRUE, контроллер домена является основным контроллером домена; в противном случае контроллер домена не является основным контроллером домена.

fDsEnabled

Логическое значение, указывающее, включен ли контроллер домена. Если это значение равно TRUE, контроллер домена включен; в противном случае она не включена.

Замечания

Функция DsGetDomainControllerInfo может возвращать различные версии этой структуры. Дополнительные сведения и список поддерживаемых версий см. в параметре InfoLevelDsGetDomainControllerInfo.

Заметка

Заголовок ntdsapi.h определяет DS_DOMAIN_CONTROLLER_INFO_1 как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

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

См. также

структуры управления доменами и репликацией

DsGetDomainControllerInfo

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