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.
Anmerkung
Der ntdsapi.h-Header definiert DsListServersForDomainInSite 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 |