DsListInfoForServerA-Funktion (ntdsapi.h)
Die DsListInfoForServer-Funktion listet verschiedene Daten für einen Server auf.
Syntax
NTDSAPI DWORD DsListInfoForServerA(
[in] HANDLE hDs,
[in] LPCSTR server,
[out] PDS_NAME_RESULTA *ppInfo
);
Parameter
[in] hDs
Enthält ein Verzeichnisdiensthandle, das von der FUNKTION DSBind oder DSBindWithCred abgerufen wurde.
[in] server
Zeiger auf eine NULL-beendete Zeichenfolge, die den Servernamen angibt. Dieser Name muss mit einer der Zeichenfolgen übereinstimmen, die von der DsListServersForDomainInSite - oder DsListServersInSite-Funktion zurückgegeben werden.
[out] ppInfo
Zeiger auf eine Variable, die einen Zeiger auf eine DS_NAME_RESULT Struktur empfängt, die die Serverdaten enthält. Die zurückgegebene Struktur muss mithilfe von DsFreeNameResult zugeordnet werden.
Die Indizes des Arrays in der DS_NAME_RESULT Struktur geben an, welche Daten in jedem Arrayelement enthalten sind. Die folgenden Konstanten können verwendet werden, um den gewünschten Index für eine bestimmte Datenmenge anzugeben.
DS_LIST_ACCOUNT_OBJECT_FOR_SERVER
Name des Kontoobjekts für den Domänencontroller (DC).
DS_LIST_DNS_HOST_NAME_FOR_SERVER
DNS-Hostname des DC.
DS_LIST_DSA_OBJECT_FOR_SERVER
GUID des Verzeichnisdienst-Agents (DSA) für den Domänencontroller (DC).
Rückgabewert
Wenn die Funktion Serverdaten zurückgibt, wird der Rückgabewert NO_ERROR.
Wenn die Funktion fehlschlägt, kann der Rückgabewert einer der folgenden Fehlercodes sein.
Hinweise
Fehler bei der Konvertierung einzelner Namen werden in der zurückgegebenen DS_NAME_RESULT-Struktur gemeldet.
Hinweis
Der ntdsapi.h-Header definiert DsListInfoForServer als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante 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 |
| Zielplattform | Windows |
| Kopfzeile | ntdsapi.h |
| Bibliothek | Ntdsapi.lib |
| DLL | Ntdsapi.dll |