IDsBrowseDomainTree::GetDomains method (dsclient.h)
The IDsBrowseDomainTree::GetDomains method retrieves the trust domains of the current computer. The current computer is set using the IDsBrowseDomainTree::SetComputer method.
Syntax
HRESULT GetDomains(
[in] PDOMAIN_TREE *ppDomainTree,
[in] DWORD dwFlags
);
Parameters
[in] ppDomainTree
Pointer to a DOMAINTREE structure pointer that receives the trust domain data. The caller must free this memory when no longer required by calling IDsBrowseDomainTree::FreeDomains.
[in] dwFlags
Contains a set of flags that modify the domain contents. This can be zero or a combination of one or more of the following values.
DBDTF_RETURNFQDN
The pszNCName members of the DOMAINDESC structures will receive the fully qualified domain names. The fully qualified domain name takes the form "DC=myDom, DC=Fabrikam, DC=com" as opposed to "myDom.Fabrikam.com".
DBDTF_RETURNMIXEDDOMAINS
The method will return downlevel trust domains.
DBDTF_RETURNEXTERNAL
The method will return external trust domains.
DBDTF_RETURNINBOUND
If this flag is set, the method returns trusting domains. If this flag is not set, the method returns trusted domains.
DBDTF_RETURNINOUTBOUND
The method will return both trusted and trusting domains.
Return value
Returns a standard HRESULT value including the following.
Remarks
For more information about how to access and use the data provided by this method, see Domain Browser.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows Vista |
| Minimum supported server | Windows Server 2008 |
| Target Platform | Windows |
| Header | dsclient.h |
| DLL | Dsadmin.dll |