Freigeben über


DS_DOMAIN_CONTROLLER_INFO_3A-Struktur (ntdsapi.h)

Die DS_DOMAIN_CONTROLLER_INFO_3-Struktur enthält Daten zu einem Domänencontroller. Diese Struktur wird von der DsGetDomainControllerInfo-Funktion zurückgegeben.

Syntax

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;
  BOOL  fIsRodc;
  GUID  SiteObjectGuid;
  GUID  ComputerObjectGuid;
  GUID  ServerObjectGuid;
  GUID  NtdsDsaObjectGuid;
} DS_DOMAIN_CONTROLLER_INFO_3A, *PDS_DOMAIN_CONTROLLER_INFO_3A;

Member

NetbiosName

Zeiger auf eine NULL-endende Zeichenfolge, die den NetBIOS-Namen des Domänencontrollers angibt.

DnsHostName

Zeiger auf eine NULL-endende Zeichenfolge, die den DNS-Hostnamen des Domänencontrollers angibt.

SiteName

Zeiger auf eine NULL-endende Zeichenfolge, die den Standort angibt, zu dem der Domänencontroller gehört.

SiteObjectName

Zeiger auf eine NULL-endende Zeichenfolge, die den Namen des Standortobjekts auf dem Domänencontroller angibt.

ComputerObjectName

Zeiger auf eine NULL-endende Zeichenfolge, die den Namen des Computerobjekts auf dem Domänencontroller angibt.

ServerObjectName

Zeiger auf eine NULL-endende Zeichenfolge, die den Namen des Serverobjekts auf dem Domänencontroller angibt.

NtdsDsaObjectName

Zeiger auf eine NULL-endende Zeichenfolge, die den Namen des NTDS DSA-Objekts auf dem Domänencontroller angibt.

fIsPdc

Ein boolescher Wert, der angibt, ob dieser Domänencontroller der primäre Domänencontroller ist. Wenn dieser Wert TRUE ist, ist der Domänencontroller der primäre Domänencontroller. Andernfalls ist der Domänencontroller nicht der primäre Domänencontroller.

fDsEnabled

Ein boolescher Wert, der angibt, ob der Domänencontroller aktiviert ist. Wenn dieser Wert TRUE ist, ist der Domänencontroller aktiviert. Andernfalls ist es nicht aktiviert.

fIsGc

Ein boolescher Wert, der angibt, ob es sich beim Domänencontroller um einen globalen Katalogserver handelt. Wenn dieser Wert TRUE ist, ist der Domänencontroller ein globaler Katalogserver. Andernfalls handelt es sich nicht um einen globalen Katalogserver.

fIsRodc

Ein boolescher Wert, der angibt, ob der Domänencontroller ein schreibgeschützter Domänencontroller ist. Wenn dieser Wert TRUE ist, ist der Domänencontroller ein schreibgeschützter Domänencontroller. Andernfalls handelt es sich nicht um einen schreibgeschützten Domänencontroller.

SiteObjectGuid

Enthält die GUID für das Standortobjekt auf dem Domänencontroller.

ComputerObjectGuid

Enthält die GUID für das Computerobjekt auf dem Domänencontroller.

ServerObjectGuid

Enthält die GUID für das Serverobjekt auf dem Domänencontroller.

NtdsDsaObjectGuid

Enthält die GUID für das NTDS DSA-Objekt auf dem Domänencontroller.

Hinweise

Die DsGetDomainControllerInfo-Funktion kann verschiedene Versionen dieser Struktur zurückgeben. Weitere Informationen und eine Liste der derzeit unterstützten Versionen finden Sie im InfoLevel-Parameter von DsGetDomainControllerInfo.

Hinweis

Der ntdsapi.h-Header definiert DS_DOMAIN_CONTROLLER_INFO_3 als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista
Unterstützte Mindestversion (Server) Windows Server 2008
Kopfzeile ntdsapi.h

Weitere Informationen

Domänencontroller- und Replikationsverwaltungsstrukturen

DsGetDomainControllerInfo