Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Die funktion DsListSites listet alle Websites in der Unternehmensstruktur auf.
Syntax
NTDSAPI DWORD DsListSitesA(
[in] HANDLE hDs,
[out] PDS_NAME_RESULTA *ppSites
);
Parameter
[in] hDs
Enthält ein Verzeichnisdiensthandle, das entweder vom DSBind- oder DSBindWithCredWithCred-Funktion abgerufen wird.
[out] ppSites
Zeigen Sie auf einen Zeiger auf eine DS_NAME_RESULT Struktur, die die Liste der Websites im Unternehmen empfängt. Der Websitename wird im DN-Format (Distinguished Name) zurückgegeben. Die zurückgegebene Struktur muss mithilfe der DsFreeNameResult-Funktion freigegeben werden.
Rückgabewert
Wenn die Funktion eine Liste von Websites 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 DsListSites 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 |