DOMAIN_CONTROLLER_INFOA-Struktur (dsgetdc.h)

Die DOMAIN_CONTROLLER_INFO-Struktur wird mit der DsGetDcName-Funktion verwendet, um Daten zu einem Domänencontroller zu empfangen.

Syntax

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;

Member

DomainControllerName

Zeiger auf eine NULL-Zeichenfolge, die den Computernamen des ermittelten Domänencontrollers angibt. Dem zurückgegebenen Computernamen wird "\" vorangestellt. Der DNS-Formatname, z. B. "\phoenix.fabrikam.com", wird zurückgegeben, sofern verfügbar. Wenn der DNS-Formatname nicht verfügbar ist, wird der flache Name (z. B. "\phoenix") zurückgegeben. Dieses Beispiel gilt, wenn es sich bei der Domäne um eine Windows NT 4.0-Domäne handelt oder wenn die Domäne die IP-Protokollfamilie nicht unterstützt.

DomainControllerAddress

Zeiger auf eine NULL-beendete Zeichenfolge, die die Adresse des ermittelten Domänencontrollers angibt. Die Adresse hat das Präfix "\". Diese Zeichenfolge ist einer der Typen, die vom DomainControllerAddressType-Member definiert werden.

DomainControllerAddressType

Gibt den Typ der Zeichenfolge an, die im Member DomainControllerAddress enthalten ist. Dies kann einer der folgenden Werte sein.

DS_INET_ADDRESS

Die Adresse ist eine Zeichenfolgen-IP-Adresse (z. B. "\157.55.94.74") des Domänencontrollers.

DS_NETBIOS_ADDRESS

Die Adresse ist ein NetBIOS-Name, z. B. "\phoenix", des Domänencontrollers.

DomainGuid

Die GUID der Domäne. Dieser Member ist 0, wenn der Domänencontroller keine Domänen-GUID aufweist. Beispielsweise ist der Domänencontroller kein Windows 2000-Domänencontroller.

DomainName

Zeiger auf eine NULL-Zeichenfolge, die den Namen der Domäne angibt. Der DNS-Formatname, z. B. "fabrikam.com", wird zurückgegeben, sofern verfügbar. Andernfalls wird der flache Name, z. B. "fabrikam", zurückgegeben. Dieser Name kann sich vom angeforderten Domänennamen unterscheiden, wenn die Domäne umbenannt wurde.

DnsForestName

Zeiger auf eine NULL-Zeichenfolge, die den Namen der Domäne am Stamm der DS-Struktur angibt. Der DNS-Formatname, z. B. "fabrikam.com", wird zurückgegeben, sofern verfügbar. Andernfalls wird der flache Name zurückgegeben, z. B. "fabrikam".

Flags

Enthält eine Reihe von Flags, die den Domänencontroller beschreiben. Dies kann null oder eine Kombination aus einem oder mehreren der folgenden Werte sein.

DS_DNS_CONTROLLER_FLAG

Das DomainControllerName-Element befindet sich im DNS-Format.

DS_DNS_DOMAIN_FLAG

Das DomainName-Element befindet sich im DNS-Format.

DS_DNS_FOREST_FLAG

Das DnsForestName-Element befindet sich im DNS-Format.

DS_CLOSEST_FLAG

Der Domänencontroller befindet sich am selben Standort wie der Client.

DS_DS_FLAG

Der Domänencontroller ist ein Verzeichnisdienstserver für die Domäne.

DS_FULL_SECRET_DOMAIN_6_FLAG

Der Domänencontroller ist ein beschreibbarer Windows 2008-Domänencontroller oder höher.

DS_GOOD_TIMESERV_FLAG

Der Domänencontroller führt einen zuverlässigen Windows-Zeitdienst für die Domäne aus.

DS_GC_FLAG

Der Domänencontroller ist ein globaler Katalogserver für die durch DnsForestName angegebene Gesamtstruktur.

DS_KDC_FLAG

Der Domänencontroller ist ein Kerberos-Schlüsselverteilungscenter für die Domäne.

DS_LDAP_FLAG

Der Server ist ein LDAP-Server.

DS_NDNC_FLAG

Der Domänenname ist ein Anwendungskontext (nicht Domänenname).

DS_PDC_FLAG

Der Domänencontroller ist der primäre Domänencontroller der Domäne.

DS_SELECT_SECRET_DOMAIN_6_FLAG

Der Domänencontroller ist ein schreibgeschützter Domänencontroller unter Windows 2008 oder höher.

DS_TIMESERV_FLAG

Der Domänencontroller führt den Windows-Zeitdienst für die Domäne aus.

DS_WRITABLE_FLAG

Der Domänencontroller hostet einen beschreibbaren Verzeichnisdienst (SAM).

DcSiteName

Zeiger auf eine NULL-Zeichenfolge, die den Namen des Standorts angibt, an dem sich der Domänencontroller befindet. Dieser Member kann NULL sein, wenn sich der Domänencontroller nicht an einem Standort befindet. Der Domänencontroller ist beispielsweise ein Windows NT 4.0-Domänencontroller.

ClientSiteName

Zeiger auf eine NULL-Zeichenfolge, die den Namen des Standorts angibt, zu dem der Computer gehört. Der Computer wird im ComputerName-Parameter angegeben, der an DsGetDcName übergeben wird. Dieser Member kann NULL sein, wenn der Standort, der den Computer enthält, nicht gefunden werden kann. Beispielsweise, wenn der DS-Administrator das Subnetz, in dem sich der Computer befindet, nicht einem gültigen Standort zugeordnet hat.

Hinweise

Hinweis

Der dsgetdc.h-Header definiert DOMAIN_CONTROLLER_INFO 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 nicht codierungsneutralem Code 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	dsgetdc.h

Weitere Informationen

Verzeichnisdienststrukturen

Dsgetdcname