DsListServersForDomainInSiteA-Funktion (ntdsapi.h)

Die funktion DsListServersForDomainInSite listet alle Server in einer Domäne auf einem Standort 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 entweder vom DSBind- oder DSBindWithCredWithCred-Funktion abgerufen wird.

[in] domain

Zeigen Sie auf eine mit Null beendete Zeichenfolge, die den Domänennamen angibt. Diese Zeichenfolge muss mit einer der von DsListDomainsInSite Funktion zurückgegebenen Zeichenfolgen identisch sein.

[in] site

Zeigen Sie auf eine mit Null beendete Zeichenfolge, die den Websitenamen angibt. Diese Zeichenfolge stammt aus der Liste der Websitenamen, 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 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.

Bemerkungen

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

Anforderungen

Siehe auch

DS_NAME_RESULT

Domänencontroller- und Replikationsverwaltungsfunktionen

DsFreeNameResult-