IDsBrowseDomainTree::BrowseTo-Methode (dsclient.h)

Die IDsBrowseDomainTree::BrowseTo-Methode zeigt ein Dialogfeld an, das zum Suchen nach einer Domäne verwendet wird.

Syntax

HRESULT BrowseTo(
  [in]  HWND   hwndParent,
  [out] LPWSTR *ppszTargetPath,
  [in]  DWORD  dwFlags
);

Parameter

[in] hwndParent

Handle des Fensters, das der Besitzer des Dialogfelds "Domänenbrowser" sein wird.

[out] ppszTargetPath

Zeiger auf einen Unicode-Zeichenfolgenzeiger, der die Pfadzeichenfolge der im Domänenbrowser ausgewählten Domäne empfängt. Dieser Arbeitsspeicher muss freigegeben werden, wenn er durch Aufrufen von CoTaskMemFree nicht mehr benötigt wird. Standardmäßig hat dieser Pfad die Form "myDom.Fabrikam.com". Wenn dwFlags das flag DBDTF_RETURNFQDN enthält, hat der Pfad die Form "DC=myDom, DC=Fabrikam, DC=com".

[in] dwFlags

Enthält eine Reihe von Flags, die das Verhalten des Domänenbrowserdialogfelds ändern. Dies kann null oder eine Kombination aus einem oder mehreren der folgenden Werte sein.

DBDTF_RETURNFQDN

Der Domänenbrowser platziert den vollqualifizierten Domänennamen in ppszTargetPath. Der vollqualifizierte Domänenname hat das Format "DC=myDom, DC=Fabrikam, DC=com" im Gegensatz zu "myDom.Fabrikam.com".

DBDTF_RETURNMIXEDDOMAINS

Der Domänenbrowser zeigt vertrauensbasierte Domänen auf downlevel an.

DBDTF_RETURNEXTERNAL

Der Domänenbrowser zeigt externe Vertrauensdomänen an.

DBDTF_RETURNINBOUND

Wenn dieses Flag festgelegt ist, zeigt der Domänenbrowser vertrauende Domänen an. Andernfalls zeigt der Domänenbrowser vertrauenswürdige Domänen an.

DBDTF_RETURNINOUTBOUND

Der Domänenbrowser zeigt sowohl vertrauenswürdige als auch vertrauenswürdige Domänen an.

Rückgabewert

Gibt einen HRESULT-Standardwert zurück, der Folgendes enthält.

Anforderungen

Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	Windows Server 2008
Zielplattform	Windows
Kopfzeile	dsclient.h
DLL	Dsadmin.dll

Weitere Informationen

CoTaskMemFree

IDsBrowseDomainTree