| Directory Services |
The IDsBrowseDomainTree interface is used by an application to display a domain browser dialog box and/or obtain a list of trust domains related to a given computer.
The IDsBrowseDomainTree interface inherits the methods of the standard COM interface IUnknown.
In addition, IDsBrowseDomainTree defines the following methods.
| Method | Description |
|---|---|
| BrowseTo | Displays a dialog box used to browse for a domain. |
| GetDomains | Retrieves the trust domains of the current computer. |
| FreeDomains | Frees the memory allocated by the IDsBrowseDomainTree::GetDomains method. |
| FlushCachedDomains | Frees the cached domain list. |
| SetComputer | Specifies the computer and credentials to be used by this instance of the IDsBrowseDomainTree interface. |
An instance of this interface is created by calling CoCreateInstance with the CLSID_DsDomainTreeBrowser class identifier as shown below.
HRESULT hr = S_OK;
IDsBrowseDomainTree *pDSB = NULL;
hr = CoCreateInstance( CLSID_DsDomainTreeBrowser,
NULL,
CLSCTX_INPROC_SERVER,
IID_IDsBrowseDomainTree,
(void**)&pDSB);
if(SUCCEEDED(hr))
{
//use the IDsBrowseDomainTree object
//release the IDsBrowseDomainTree object
pDSB->Release();
}
Client: Included in Windows XP and
Windows 2000 Professional.
Server: Included in Windows Server 2003 and
Windows 2000 Server.
Header: Declared in Dsclient.h.
CoCreateInstance