DsListServersForDomainInSiteA-Funktion (ntdsapi.h)

Artikel
02/29/2024

Die DsListServersForDomainInSite-Funktion listet alle Server in einer Domäne eines Standorts auf.

Syntax

NTDSAPI DWORD DsListServersForDomainInSiteA(
  [in]  HANDLE           hDs,
  [in]  LPCSTR           domain,
  [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] domain

Zeiger auf eine null-beendete Zeichenfolge, die den Domänennamen angibt. Diese Zeichenfolge muss mit einer der Zeichenfolgen übereinstimmen, die von der DsListDomainsInSite-Funktion zurückgegeben werden.

[in] site

Zeiger auf eine NULL-Zeichenfolge, die den Websitenamen angibt. Diese Zeichenfolge wird aus der Liste der Websitenamen 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 in der Domäne 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 DsListServersForDomainInSite 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

Weitere Informationen

DS_NAME_RESULT

Domänencontroller und Replikationsverwaltungsfunktionen

DsFreeNameResult

Freigeben über