DsBrowseForContainerW 関数 (dsclient.h)

DsBrowseForContainer 関数は、Active Directory Domain Services のコンテナー オブジェクトを参照するために使用するダイアログ ボックスを表示します。

構文

int DsBrowseForContainerW(
  [in] PDSBROWSEINFOW pInfo
);

パラメーター

[in] pInfo

コンテナー ブラウザー ダイアログの初期化に関するデータを格納し、選択したオブジェクトに関するデータを受け取る、DSBROWSEINFO 構造体へのポインター。

戻り値

ユーザーがコンテナーを選択して [OK] ボタンをクリックするか、オブジェクトをダブルクリックすると、この関数は IDOK を返します。 ユーザーがダイアログ ボックスをキャンセルすると、関数は IDCANCEL を返します。 エラーが発生した場合、関数は -1を返します。 GetLastError 関数を使用して、拡張エラー情報を取得します。

備考

ダイアログ ボックスには、特定のルートのコンテナーが設定されているか、信頼されたドメインを使用するコンテナー ピッカーが表示されます。 信頼されたドメインを使用する場合は、ユーザーが現在ログオンしているドメインを使用するか、DSBROWSEINFO 構造体の pszRoot メンバーを使用してアプリケーションで指定された代替ドメインを使用できます。 ユーザーが [OK] ボタンをクリックするか、オブジェクトをダブルクリックすると、 IDOK が返され、 pszPath に選択したオブジェクトの ADsPath が含まれます。 ユーザーがダイアログ ボックスを取り消すと、DsBrowseForContainer は IDCANCEL返します。

pszRoot メンバーには ADsPath が含まれています。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
    }
}

必要条件

関連項目

BFFCallBack の

DSBROWSEINFO の