DsGetDomainControllerInfoA-Funktion (ntdsapi.h)
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 |