指定したドメインに対応する GPMDomain オブジェクトを作成して返します。
オブジェクトを使用すると、次の操作を実行できます。
- グループ ポリシー オブジェクト (GPO) の作成、クエリ、復元
- 管理 (SOM) オブジェクトの検索範囲
- Windows Management Instrumentation (WMI) フィルターの検索と取得
構文
HRESULT GetDomain(
[in] BSTR bstrDomain,
[in] BSTR bstrDomainController,
[in] long lDCFlags,
[out] IGPMDomain **pIGPMDomain
);
パラメーター
[in] bstrDomain
文字列として指定されたドメインの名前。 これは、 などの contoso.com完全なドメイン ネーム システム (DNS) 名である必要があります。
[in] bstrDomainController
指定した場合、ドメインで使用するドメイン コントローラーの名前。 名前には、DNS 名または NetBIOS 名を指定できます。 それ以外の場合、メソッドはプライマリ ドメイン コントローラー (PDC) を使用します。 詳細については、 lDCFlags パラメーターを参照してください。
スクリプト： ドメイン コントローラーが指定されていない場合、このパラメーターは空の文字列 ("") を渡す必要があります。
[in] lDCFlags
ドメインのドメイン コントローラーを検索するために使用するフラグ。 GPM_USE_ANYDC、GPM_USE_PDC、またはGPM_DONOTUSE_W2KDCを指定できます。
このパラメーターを 0 に設定し、 bstrDomainController を指定した場合、メソッドは指定された bstrDomainController を使用します。 それ以外の場合、メソッドは PDC を使用します。
[out] pIGPMDomain
IGPMDomain インターフェイスへのポインターのアドレス。
戻り値
C++
成功した場合 はS_OK を返します。 エラーが発生した場合にエラー コードを返します。JScript
GPMDomain オブジェクトへの参照を返します。VB
GPMDomain オブジェクトへの参照を返します。注釈
大事な： この関数を呼び出すと、基になる LDAP トラフィックは SSL ではなく Kerberos を使用して暗号化されます。
この方法では、サイトの SOM を検索できません。 この種類のクエリを実行するには、 IGPM::GetSitesContainer メソッドを呼び出します。
要件
| サポートされている最小のクライアント | Windows Vista |
| サポートされている最小のサーバー | Windows Server 2008 |
| 対象プラットフォーム | Windows |
| ヘッダー | gpmgmt.h |
| [DLL] | Gpmgmt.dll |