DsBrowseForContainerA 関数 (dsclient.h)
DsBrowseForContainer 関数は、Active Directory Domain Services内のコンテナー オブジェクトを参照するために使用されるダイアログ ボックスを表示します。
構文
int DsBrowseForContainerA(
[in] PDSBROWSEINFOA pInfo
);
パラメーター
[in] pInfo
コンテナー ブラウザー ダイアログの初期化に関するデータを含み、選択したオブジェクトに関するデータを受信する DSBROWSEINFO 構造体へのポインター。
戻り値
関数は、次のいずれかの値を返します。
注釈
ダイアログ ボックスには、特定のルートのコンテナーが設定されているか、信頼されたドメインを使用するコンテナー ピッカーが表示されます。 信頼されたドメインを使用する場合は、ユーザーが現在ログオンしているドメインを使用するか、DSBROWSEINFO 構造体の pszRoot メンバーを使用してアプリケーションで指定された代替ドメインを使用できます。 ユーザーが [OK] プッシュ ボタンをクリックするか、オブジェクトをダブルクリックすると、 IDOK が返され、 pszPath には選択したオブジェクトの ADsPath が含まれます。 ユーザーがダイアログ ボックスをキャンセルすると、 DsBrowseForContainer はIDCANCEL を返します。
pszRoot メンバーには、次の形式が必要な ADsPath が含まれています。
LDAP://fabrikam.com/CN=Users,DC=Fabrikam,DC=com
DsBrowseForContainer では、このパスがツリーのルートとして使用されます。 pszRoot メンバーを使用して、ユーザーがログオンしているドメインとの信頼を持つドメインを指定して、ユーザーが代替ドメインの Users コンテナーを参照できるようにすることもできます。 pszPath メンバーにパスが含まれている場合、ダイアログは pszRoot からコンテナー内を移動し、pszPath で指定されたオブジェクトに到達します。
DsBrowseForContainer 関数は、DSBROWSEINFO 構造体で指定されたコールバック関数をサポートします。 コールバック関数を使用すると、選択の変更などに基づいてビューをフィルター処理、変更、または更新できます。 詳細については、「 BFFCallBack」を参照してください。
例
次のコード例では、ユーザーがログオンしているドメイン内のコンテナーを選択します。 ビューには、すべての信頼されたドメインも表示されます。
void PickContainer(void)
{
DSBROWSEINFOW dsbi = { 0 };
WCHAR wszResult[MAX_PATH];
dsbi.cbStruct = sizeof(dsbi);
dsbi.pszCaption = L"The container picker";
dsbi.pszTitle = L"Pick a container for this example.";
dsbi.pszPath = wszResult;
dsbi.cchPath = MAX_PATH;
dsbi.dwFlags = DSBI_ENTIREDIRECTORY;
int nReturn = DsBrowseForContainerW(&dsbi);
if ( IDOK == nReturn )
{
// wszResult contains the resulting path
}
}
注意
dsclient.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして DsBrowseForContainer を定義します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows Vista |
サポートされている最小のサーバー | Windows Server 2008 |
対象プラットフォーム | Windows |
ヘッダー | dsclient.h |
Library | Dsuiext.lib |
[DLL] | Dsuiext.dll |
こちらもご覧ください
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示