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」を参照してください。

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

要件

要件	値
サポートされている最小のクライアント	Windows Vista
サポートされている最小のサーバー	Windows Server 2008
対象プラットフォーム	Windows
ヘッダー	dsclient.h
Library	Dsuiext.lib
[DLL]	Dsuiext.dll

こちらもご覧ください

BFFCallBack

DSBROWSEINFO