DsListServersInSiteA-Funktion (ntdsapi.h)

Die DsListServersInSite-Funktion listet alle Server an 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 von der FUNKTION DSBind oder DSBindWithCred abgerufen wurde.

[in] site

Zeiger auf eine NULL-Zeichenfolge, die den Websitenamen angibt. Der Websitename verwendet ein Distinguished Name-Format. Sie wird aus der Liste der Websites entnommen, die von der DsListSites-Funktion zurückgegeben werden.

[out] ppServers

Zeiger 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.

Hinweise

Fehler bei der Konvertierung einzelner Namen werden in der zurückgegebenen DS_NAME_RESULT-Struktur gemeldet.

Hinweis

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 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

Weitere Informationen

DS_NAME_RESULT

Domänencontroller und Replikationsverwaltungsfunktionen

DsFreeNameResult