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

Статья
11/20/2024

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

Синтаксис

typedef struct {
#if ...
  CHAR  *NetbiosName;
#if ...
  CHAR  *DnsHostName;
#if ...
  CHAR  *SiteName;
#if ...
  CHAR  *SiteObjectName;
#if ...
  CHAR  *ComputerObjectName;
#if ...
  CHAR  *ServerObjectName;
#if ...
  CHAR  *NtdsDsaObjectName;
#else
  LPSTR NetbiosName;
#endif
#else
  LPSTR DnsHostName;
#endif
#else
  LPSTR SiteName;
#endif
#else
  LPSTR SiteObjectName;
#endif
#else
  LPSTR ComputerObjectName;
#endif
#else
  LPSTR ServerObjectName;
#endif
#else
  LPSTR NtdsDsaObjectName;
#endif
  BOOL  fIsPdc;
  BOOL  fDsEnabled;
  BOOL  fIsGc;
  GUID  SiteObjectGuid;
  GUID  ComputerObjectGuid;
  GUID  ServerObjectGuid;
  GUID  NtdsDsaObjectGuid;
} DS_DOMAIN_CONTROLLER_INFO_2A, *PDS_DOMAIN_CONTROLLER_INFO_2A;

Члены

NetbiosName

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

DnsHostName

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

SiteName

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

SiteObjectName

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

ComputerObjectName

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

ServerObjectName

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

NtdsDsaObjectName

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

fIsPdc

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

fDsEnabled

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

fIsGc

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

SiteObjectGuid

Содержит идентификатор GUID для объекта сайта на контроллере домена.

ComputerObjectGuid

Содержит идентификатор GUID для объекта компьютера на контроллере домена.

ServerObjectGuid

Содержит идентификатор GUID для объекта сервера на контроллере домена.

NtdsDsaObjectGuid

Содержит идентификатор GUID для объекта DSA NTDS на контроллере домена.

Замечания

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

Заметка

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

Требования

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

См. также

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

DsGetDomainControllerInfo

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