トレーニング
ドメインブラウザー
IDsBrowseDomainTreeインターフェイスを使用すると、アプリケーションでドメインブラウザーダイアログボックスを表示し、ユーザーが選択したドメインのDNS名を取得できます。 アプリケーションでは、IDsBrowseDomainTreeインターフェイスを使用して、フォレスト内のすべてのドメインツリーとドメインに関するデータを取得することもできます。
IDsBrowseDomainTreeインターフェイスのインスタンスは、次に示すように、CLSID_DsDomainTreeBrowserクラス識別子を使用してCoCreateInstanceを呼び出すことによって作成されます。
IDsBrowseDomainTree :: SetComputerメソッドを使用して、ドメインデータを取得するための基礎として使用するコンピューターと資格情報を指定できます。 特定のIDsBrowseDomainTreeインスタンスでSetComputerが呼び出されると、SetComputerが再度呼び出される前にIDsBrowseDomainTree :: FlushCachedDomainsを呼び出す必要があります。
IDsBrowseDomainTree :: BrowseToメソッドは、 [ドメインブラウザー] ダイアログボックスを表示するために使用されます。 ユーザーがドメインを選択し、 [OK] ボタンをクリックすると、IDsBrowseDomainTree :: BrowseToはS_OKを返し、ppszTargetPathパラメーターには選択したドメインの名前が含まれます。 名前の文字列が不要になった場合、呼び出し元はCoTaskMemFreeを呼び出して文字列を解放する必要があります。
次のコード例は、IIDsBrowseDomainTreeインターフェイスを使用して [ドメインブラウザー] ダイアログボックスを表示する方法を示しています。
#include <shlobj.h>
#include <dsclient.h>
void main(void)
{
HRESULT hr;
hr = CoInitialize(NULL);
if(FAILED(hr))
{
return;
}
IDsBrowseDomainTree *pDsDomains = NULL;
hr = ::CoCreateInstance( CLSID_DsDomainTreeBrowser,
NULL,
CLSCTX_INPROC_SERVER,
IID_IDsBrowseDomainTree,
(void **)(&pDsDomains));
if(SUCCEEDED(hr))
{
LPOLESTR pstr;
hr = pDsDomains->BrowseTo( GetDesktopWindow(),
&pstr,
0);
if(S_OK == hr)
{
wprintf(pstr);
wprintf(L"\n");
CoTaskMemFree(pstr);
}
pDsDomains->Release();
}
CoUninitialize();
}
IDsBrowseDomainTree :: GetDomainsメソッドは、ドメインツリーデータを取得するために使用されます。 ドメインデータは、DOMAINTREE構造体で提供されます。 DOMAINTREE構造体には、構造体のサイズとツリー内のドメイン要素の数が含まれています。 DOMAINTREE構造体には、1つ以上のDOMAINDESC構造体も含まれています。 DOMAINDESCには、子データと兄弟データを含む、ドメインツリー内の1つの要素に関するデータが含まれています。 ドメインの兄弟は、後続の各DOMAINDESC構造体のpdNextSiblingメンバーにアクセスすることによって列挙できます。 ドメインの子は、後続の各DOMAINDESC構造体のpdChildListメンバーにアクセスすることによって、同様の方法で取得できます。
次のコード例は、IDsBrowseDomainTree :: GetDomainsメソッドを使用してドメインツリーデータを取得し、アクセスする方法を示しています。
// Add dsuiext.lib to the project.
#include "stdafx.h"
#include <shlobj.h>
#include <dsclient.h>
//The PrintDomain() function displays the domain name
void PrintDomain(DOMAINDESC *pDomainDesc, DWORD dwIndentLevel)
{
DWORD i;
// Display the domain name.
for(i = 0; i < dwIndentLevel; i++)
{
wprintf(L" ");
}
wprintf(pDomainDesc->pszName);
wprintf(L"\n");
}
//The WalkDomainTree() function traverses the domain tree and prints the current domain name
void WalkDomainTree(DOMAINDESC *pDomainDesc, DWORD dwIndentLevel = 0)
{
DOMAINDESC *pCurrent;
// Walk through the current item and any siblings it may have.
for(pCurrent = pDomainDesc;
NULL != pCurrent;
pCurrent = pCurrent->pdNextSibling)
{
// Print the current domain name.
PrintDomain(pCurrent, dwIndentLevel);
// Walk the child tree, if one exists.
if(NULL != pCurrent->pdChildList)
{
WalkDomainTree(pCurrent->pdChildList,
dwIndentLevel + 1);
}
}
}
// Entry point for application
int main(void)
{
HRESULT hr;
IDsBrowseDomainTree *pBrowseTree;
CoInitialize(NULL);
hr = CoCreateInstance(CLSID_DsDomainTreeBrowser,
NULL,
CLSCTX_INPROC_SERVER,
IID_IDsBrowseDomainTree,
(void**)&pBrowseTree);
if(SUCCEEDED(hr))
{
DOMAINTREE *pDomTreeStruct;
hr = pBrowseTree->GetDomains(&pDomTreeStruct,
DBDTF_RETURNFQDN);
if(SUCCEEDED(hr))
{
WalkDomainTree(&pDomTreeStruct->aDomains[0]);
hr = pBrowseTree->FreeDomains(&pDomTreeStruct);
}
pBrowseTree->Release();
}
CoUninitialize();
}