DOMAIN_CONTROLLER_INFOW Struktur (dsgetdc.h)
Die DOMAIN_CONTROLLER_INFO-Struktur wird mit der DsGetDcName--Funktion verwendet, um Daten über einen Domänencontroller zu empfangen.
Syntax
typedef struct _DOMAIN_CONTROLLER_INFOW {
#if ...
wchar_t *DomainControllerName;
#else
LPWSTR DomainControllerName;
#endif
#if ...
wchar_t *DomainControllerAddress;
#else
LPWSTR DomainControllerAddress;
#endif
ULONG DomainControllerAddressType;
GUID DomainGuid;
#if ...
wchar_t *DomainName;
#else
LPWSTR DomainName;
#endif
#if ...
wchar_t *DnsForestName;
#else
LPWSTR DnsForestName;
#endif
ULONG Flags;
#if ...
wchar_t *DcSiteName;
#else
LPWSTR DcSiteName;
#endif
#if ...
wchar_t *ClientSiteName;
#else
LPWSTR ClientSiteName;
#endif
} DOMAIN_CONTROLLER_INFOW, *PDOMAIN_CONTROLLER_INFOW;
Angehörige
DomainControllerName
Zeigen Sie auf eine mit Null beendete Zeichenfolge, die den Computernamen des ermittelten Domänencontrollers angibt. Der zurückgegebene Computername wird mit dem Präfix "\" versehen. Der DNS-Formatvorlagenname, z. B. "\phoenix.fabrikam.com", wird zurückgegeben, sofern verfügbar. Wenn der NAME der DNS-Formatvorlage nicht verfügbar ist, wird der Name der flachen Formatvorlage (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
Zeigen Sie auf eine mit Null beendete Zeichenfolge, die die Adresse des ermittelten Domänencontrollers angibt. Die Adresse wird mit dem Präfix "\" versehen. Diese Zeichenfolge ist einer der Typen, die vom DomainControllerAddressType Member definiert sind.
DomainControllerAddressType
Gibt den Typ der Zeichenfolge an, die im DomainControllerAddress Mitglied 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. Dieses Mitglied ist null, wenn der Domänencontroller keine Domänen-GUID besitzt. Beispielsweise ist der Domänencontroller kein Windows 2000-Domänencontroller.
DomainName
Zeigen Sie auf eine mit Null beendete Zeichenfolge, die den Namen der Domäne angibt. Der DNS-Formatvorlagenname, z. B. "fabrikam.com", wird zurückgegeben, falls verfügbar. Andernfalls wird der Name des flachen Stils zurückgegeben, z. B. "fabrikam". Dieser Name kann sich von dem angeforderten Domänennamen unterscheiden, wenn die Domäne umbenannt wurde.
DnsForestName
Zeigen Sie auf eine mit Null beendete Zeichenfolge, die den Namen der Domäne im Stammverzeichnis der DS-Struktur angibt. Der DNS-Formatvorlagenname, z. B. "fabrikam.com", wird zurückgegeben, falls verfügbar. Andernfalls wird der Name des flachen Stils 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
Der DomainControllerName Member ist im DNS-Format.
DS_DNS_DOMAIN_FLAG
Der DomainName Member befindet sich im DNS-Format.
DS_DNS_FOREST_FLAG
Der DnsForestName Member ist im DNS-Format.
DS_CLOSEST_FLAG
Der Domänencontroller befindet sich am gleichen 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 Windows 2008- oder höher schreibbarer Domänencontroller.
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 Gesamtstruktur, die durch DnsForestNameangegeben wird.
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 Namenskontext einer Anwendung (nicht domäne).
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 Windows 2008- oder höher-schreibgeschützter Domänencontroller.
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 schreibbaren Verzeichnisdienst (oder SAM).
DcSiteName
Zeigen Sie auf eine mit Null beendete Zeichenfolge, die den Namen des Standorts angibt, an dem sich der Domänencontroller befindet. Dieses Mitglied kann NULL- sein, wenn sich der Domänencontroller nicht an einem Standort befindet; Beispielsweise ist der Domänencontroller ein Windows NT 4.0-Domänencontroller.
ClientSiteName
Zeigen Sie auf eine mit Null beendete Zeichenfolge, die den Namen der Website angibt, zu der der Computer gehört. Der Computer wird im parameter ComputerName angegeben, der an DsGetDcNameübergeben wird. Dieses Element kann NULL- sein, wenn die Website, die den Computer enthält, nicht gefunden werden kann; Wenn beispielsweise der DS-Administrator das Subnetz, in dem sich der Computer befindet, nicht mit einem gültigen Standort verknüpft hat.
Bemerkungen
Anmerkung
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 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 |
|---|---|
| mindestens unterstützte Client- | Windows Vista |
| mindestens unterstützte Server- | Windows Server 2008 |
| Header- | dsgetdc.h |