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 |