Directory Services

IDsBrowseDomainTree

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.

Methods in Vtable Order

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.

Remarks

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();
}

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

CoCreateInstance