IDsBrowseDomainTree::BrowseTo

The IDsBrowseDomainTree::BrowseTo method creates and displays a modal dialog as a domain browser.

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

Parameters

hwdnParent

[in] Handle to the window to own the domain browser dialog box.

*ppszTargetPath

[out] Pointer to the path string of the domain as selected from the browser by the user.

dwFlags

[in] Flags specifying desired domain tree contents the dialog will display. This can be a combination of the following:

dwFlags	Description
DBDTF_RETURNFQDN	If set, on return ppszTargetPath contains fully qualified domain names, such as "DC=myDom, DC=Fabrikam, DC=com"; otherwise, it contains domain name, such as "myDom", "Fabrikam.com".
DBDTF_RETURNMIXEDDOMAINS	Show downlevel trust domains.
DBDTF_RETURNEXTERNAL	Show external trust domains.
DBDTF_RETURNINBOUND	If set show trusting domains, otherwise, show trusted domains.
DBDTF_RETURNINOUTBOUND	Show both trusted and trusting domains.

Return Values

This method returns an HRESULT value.

Remarks

Upon successful return, for example, when the user selects and entry from the browser and clicks the OK button, this method returns the selection in a string that is allocated using the CoTaskMemAlloc function. The caller of this method should use CoTaskMemFree to free the string when it is no longer needed.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Header: Declared in Dsclient.h.
  Library: Included as a resource in Dsuiext.dll.

See Also

Active Directory Display Interfaces, CoTaskMemAlloc, CoTaskMemFree, DOMAINDESC, DOMAINTREE, IDsBrowseDomainTree