DsGetDomainControllerInfoA-Funktion (ntdsapi.h)

Artikel
08/25/2023

Die DsGetDomainControllerInfo-Funktion ruft Daten zu den Domänencontrollern in einer Domäne ab.

Syntax

NTDSAPI DWORD DsGetDomainControllerInfoA(
  [in]  HANDLE hDs,
  [in]  LPCSTR DomainName,
  [in]  DWORD  InfoLevel,
  [out] DWORD  *pcOut,
  [out] VOID   **ppInfo
);

Parameter

[in] hDs

Enthält ein Verzeichnisdiensthandle, das von der DSBind - oder DSBindWithCred-Funktion abgerufen wurde.

[in] DomainName

Zeiger auf eine NULL-endende Zeichenfolge, die den Domänennamen angibt.

[in] InfoLevel

Enthält einen Wert, der die Version der zurückzugebenden DS_DOMAIN_CONTROLLER_INFO-Struktur angibt. Dies kann einer der folgenden Werte sein.

1

Die Funktion stellt die Domänendaten im DS_DOMAIN_CONTROLLER_INFO_1-Strukturformat bereit.

2

Die Funktion stellt die Domänendaten im DS_DOMAIN_CONTROLLER_INFO_2-Strukturformat bereit.

3

Die Funktion stellt die Domänendaten im DS_DOMAIN_CONTROLLER_INFO_3-Strukturformat bereit.

[out] pcOut

Zeiger auf eine DWORD-Variable , die die Anzahl der im ppInfo-Array zurückgegebenen Elemente empfängt.

[out] ppInfo

Zeiger auf eine Zeigervariable, die ein Array von DS_DOMAIN_CONTROLLER_INFO_*-Strukturen empfängt . Der Typ der Strukturen in diesem Array wird durch den InfoLevel-Parameter definiert. Der Aufrufer muss dieses Array freigeben, wenn es nicht mehr erforderlich ist, indem er die DsFreeDomainControllerInfo-Funktion verwendet.

Rückgabewert

Wenn die Funktion Domänencontrollerdaten zurückgibt, wird der Rückgabewert ERROR_SUCCESS. Wenn der Aufrufer nicht über die Berechtigungen für den Zugriff auf die Serverobjekte verfügt, ist der Rückgabewert ERROR_SUCCESS, aber die DS_DOMAIN_CONTROLLER_INFO Strukturen könnten leer sein.

Wenn die Funktion fehlschlägt, kann der Rückgabewert einer der folgenden Fehlercodes sein.

Hinweise

Hinweis

Der ntdsapi.h-Header definiert DsGetDomainControllerInfo 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
Zielplattform	Windows
Kopfzeile	ntdsapi.h
Bibliothek	Ntdsapi.lib
DLL	Ntdsapi.dll