IDsBrowseDomainTree::BrowseTo

The IDsBrowseDomainTree::BrowseTo method displays a dialog box used to browse for a domain.

HRESULT BrowseTo( 
  HWND hwndParent,
  LPWSTR* ppszTargetPath,
  DWORD dwFlags
);

Parameters

hwndParent

[in] Handle of the window that will be the owner of the domain browser dialog box.

ppszTargetPath

[out] Pointer to a Unicode string pointer that receives the path string of the domain selected in the domain browser. This memory must be freed when it is no longer required by calling CoTaskMemFree. By default, this path takes the form "myDom.Fabrikam.com". If dwFlags contains the DBDTF_RETURNFQDN flag, the path takes the form "DC=myDom, DC=Fabrikam, DC=com".

dwFlags

[in] Contains a set of flags that modify the behavior of the domain browser dialog box. This can be zero or a combination of one or more of the following values.

Value	Meaning
DBDTF_RETURNFQDN	The domain browser will place the fully-qualified domain name in ppszTargetPath. The fully-qualified domain name takes the form "DC=myDom, DC=Fabrikam, DC=com" as opposed to "myDom.Fabrikam.com".
DBDTF_RETURNMIXEDDOMAINS	The domain browser will display downlevel trust domains.
DBDTF_RETURNEXTERNAL	The domain browser will display external trust domains.
DBDTF_RETURNINBOUND	If this flag is set, the domain browser will display trusting domains. Otherwise, the domain browser will display trusted domains.
DBDTF_RETURNINOUTBOUND	The domain browser will display both trusted and trusting domains.

Return Values

S_OK

The domain browser was successful.

S_FALSE

The user cancelled the domain browser dialog box.

E_INVALIDARG

ppszTargetPath is invalid.

E_OUTOFMEMORY

A memory allocation failure occurred.

Requirements

Client: Included in Windows XP and Windows 2000 Professional.
Server: Included in Windows Server 2003 and Windows 2000 Server.
Header: Declared in Dsclient.h.

See Also

CoTaskMemFree, IDsBrowseDomainTree