次の方法で共有

DsBrowseForContainerA 関数 (dsclient.h)

  • [アーティクル]

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

構文

int DsBrowseForContainerA(
  [in] PDSBROWSEINFOA pInfo
);

パラメーター

[in] pInfo

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

戻り値

この関数は、次のいずれかの値を返します。

備考

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

pszRoot メンバーには、次の形式が必要な ADsPath が含まれています。

LDAP://fabrikam.com/CN=Users,DC=Fabrikam,DC=com

dsBrowseForContainer は、このパスをツリーのルートとして使用します。 pszRoot メンバーを使用して、ユーザーがログオンしているドメインとの信頼関係を持つドメインを指定して、ユーザーが代替ドメインの Users コンテナーを参照できるようにすることもできます。 pszPath メンバーにパスが含まれている場合、ダイアログは pszRoot から、pszPathで指定されたオブジェクト 到達するまでコンテナー内を移動します。

DsBrowseForContainer 関数は、DSBROWSEINFO 構造体で指定されたコールバック関数をサポートします。 コールバック関数は、選択の変更などに基づいてビューをフィルター処理、変更、または更新するために使用できます。 詳細については、BFFCallBackを参照してください。

重要な Windows Server 2003 以降では、この関数の ANSI バージョン (DsBrowseForContainerA) は実装されておらず、常に -1 を返します。
 

例

次のコード例では、ユーザーがログオンしているドメイン内のコンテナーを選択します。 ビューには、すべての信頼されたドメインも表示されます。

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 を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。

必要条件

要件 価値
サポートされる最小クライアント Windows Vista
サポートされる最小サーバー Windows Server 2008
ターゲット プラットフォーム の ウィンドウズ
ヘッダー dsclient.h
ライブラリ Dsuiext.lib
DLL Dsuiext.dll

関連項目

BFFCallBack の

DSBROWSEINFO の