DsListServersInSiteA-Funktion (ntdsapi.h)
Die funktion DsListServersInSite listet alle Server auf einem Standort auf.
Syntax
NTDSAPI DWORD DsListServersInSiteA(
[in] HANDLE hDs,
[in] LPCSTR site,
[out] PDS_NAME_RESULTA *ppServers
);
Parameter
[in] hDs
Enthält ein Verzeichnisdiensthandle, das entweder vom DSBind- oder DSBindWithCredWithCred-Funktion abgerufen wird.
[in] site
Zeigen Sie auf eine mit Null beendete Zeichenfolge, die den Websitenamen angibt. Der Websitename verwendet ein Distinguished Name Format. Sie stammt aus der Liste der Websites, die von der funktion DsListSites zurückgegeben werden.
[out] ppServers
Zeigen Sie auf einen Zeiger auf eine DS_NAME_RESULT Struktur, die die Liste der Server am Standort empfängt. Die zurückgegebene Struktur muss mithilfe der DsFreeNameResult-Funktion freigegeben werden.
Rückgabewert
Wenn die Funktion eine Liste von Servern zurückgibt, wird der Rückgabewert NO_ERROR. Wenn die Funktion fehlschlägt, kann der Rückgabewert einer der folgenden Fehlercodes sein.
Bemerkungen
Fehler bei der Konvertierung einzelner Namen werden in der zurückgegebenen DS_NAME_RESULT Struktur gemeldet.
Anmerkung
Der ntdsapi.h-Header definiert DsListServersInSite 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 |