DsGetDomainControllerInfoA-Funktion (ntdsapi.h)
Die DsGetDomainControllerInfo Funktion ruft Daten über die Domänencontroller 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 entweder vom DSBind- oder DSBindWithCredWithCred-Funktion abgerufen wird.
[in] DomainName
Zeigen Sie auf eine mit Null beendete 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 in 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 parameter InfoLevel definiert. Der Aufrufer muss dieses Array freigeben, wenn es nicht mehr erforderlich ist, indem die funktion DsFreeDomainControllerInfo verwendet wird.
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.
Bemerkungen
Anmerkung
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 |
|---|---|
| mindestens unterstützte Client- | Windows Vista |
| mindestens unterstützte Server- | Windows Server 2008 |
| Zielplattform- | Fenster |
| Header- | ntdsapi.h |
| Library | Ntdsapi.lib |
| DLL- | Ntdsapi.dll |