Freigeben über


DsListDomainsInSiteA-Funktion (ntdsapi.h)

Die DsListDomainsInSite-Funktion listet alle Domänen auf einer Website auf.

Syntax

NTDSAPI DWORD DsListDomainsInSiteA(
  [in]  HANDLE           hDs,
  [in]  LPCSTR           site,
  [out] PDS_NAME_RESULTA *ppDomains
);

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. Diese Zeichenfolge wird aus der Liste der Websitenamen entnommen, die von der DsListSites-Funktion zurückgegeben werden.

[out] ppDomains

Zeiger auf einen Zeiger auf eine DS_NAME_RESULT Struktur, die die Liste der Domänen auf der Website empfängt. Um die zurückgegebene Struktur freizugeben, rufen Sie die DsFreeNameResult-Funktion auf.

Rückgabewert

Wenn die Funktion eine Liste von Domänen 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 DsListDomainsInSite 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