DSBROWSEINFOA 構造体 (dsclient.h)

[アーティクル]
08/23/2023

DSBROWSEINFO 構造体は、DsBrowseForContainer 関数と共に使用され、Active Directory コンテナーブラウザーダイアログボックスに関するデータを提供および返します。

構文

typedef struct {
  DWORD       cbStruct;
  HWND        hwndOwner;
  LPCSTR      pszCaption;
  LPCSTR      pszTitle;
  LPCWSTR     pszRoot;
  LPWSTR      pszPath;
  ULONG       cchPath;
  DWORD       dwFlags;
  BFFCALLBACK pfnCallback;
  LPARAM      lParam;
  DWORD       dwReturnFormat;
  LPCWSTR     pUserName;
  LPCWSTR     pPassword;
  LPWSTR      pszObjectClass;
  ULONG       cchObjectClass;
} DSBROWSEINFOA, *PDSBROWSEINFOA;

メンバー

cbStruct

DSBROWSEINFO 構造体のサイズをバイト単位で格納します。これは、バージョン管理の目的で DsBrowseForContainer 関数によって使用されます。

hwndOwner

コンテナーブラウザーダイアログボックスの親として使用されるウィンドウのハンドル。

pszCaption

ダイアログボックスのキャプションを含む null で終わる文字列へのポインター。このメンバーが NULL の場合は、既定のキャプションが使用されます。

pszTitle

ツリーコントロールの上のダイアログボックスに表示される追加のテキストを含む null で終わる文字列へのポインター。このメンバーが NULL の場合、追加のテキストは表示されません。

pszRoot

ダイアログボックスのルートに配置されたコンテナーの ADsPath を含む null で終わる Unicode 文字列へのポインター。ダイアログボックスを使用して、このレベルの上を移動することはできません。

pszPath

ダイアログで選択したコンテナーの ADsPath を受け取る null で終わる Unicode 文字列へのポインター。 cchPath がパス全体を保持するのに十分な大きさでない場合でも、この文字列は常に null で終了します。 dwFlags に DSBI_EXPANDONOPEN フラグが含まれている場合、このメンバーには、ダイアログボックスで最初に選択する必要があるコンテナーの ADsPath が含まれます。

cchPath

pszPath バッファーのサイズを WCHAR 文字で格納します。

dwFlags

ダイアログボックスの動作を定義するフラグのセットが含まれます。これは、0 または次の値の 1 つ以上の組み合わせにすることができます。

DSBI_NOBUTTONS (1 (0x1))

+ボタンと - ボタンはダイアログボックスに表示されません。

DSBI_NOLINES (2 (0x2))

ダイアログボックス内のオブジェクトを接続する線は表示されません。

DSBI_NOLINESATROOT (4 (0x4))

ルートオブジェクトの上の線とボタンは表示されません。

DSBI_CHECKBOXES (256 (0x100))

ツリー内の各項目の横にチェックボックスを配置します。ユーザーはマウスを使用して、このチェックボックスを選択してクリアできます。現在、アイテムのチェック状態を設定または取得する方法がないため、使用量は限られています。

DSBI_NOROOT (65536 (0x10000))

pszRoot で指定されたルートオブジェクトは表示されず、ルートの直接の子オブジェクトはツリーのルートに表示されます。 pszRoot が NULL の場合、またはこのメンバーにDSBI_ENTIREDIRECTORYが含まれている場合、このフラグは無効です。

DSBI_INCLUDEHIDDEN (131072 (0x20000))

ダイアログボックスに非表示オブジェクトを含めます。

DSBI_EXPANDONOPEN (262144 (0x40000))

ダイアログボックスが開くと、 pszPath で指定されたコンテナーが表示され、選択されます。

DSBI_ENTIREDIRECTORY (589824 (0x90000))

pszRoot で指定されたサーバーに対するすべての信頼されたドメイン、または既定でユーザーがログインしているドメインが含まれます。

DSBI_RETURN_FORMAT (1048576 (0x100000))

dwReturnFormat メンバーが有効であることを示します。このフラグが設定されていない場合、パス形式の既定値は X.500 になります。

DSBI_HASCREDENTIALS (2097152 (0x200000))

アクセス資格情報には、pUserName と pPassword が使用されます。それ以外の場合、このメンバー にDSBI_SIMPLEAUTHENTICATEが含まれていない場合、ダイアログは呼び出し元スレッドのセキュリティコンテキストを使用します。

DSBI_IGNORETREATASLEAF (4194304 (0x400000))

ダイアログボックスにオブジェクトが表示されるかどうかを判断する場合、 treatAsLeaf 表示指定子は無視されます。

DSBI_SIMPLEAUTHENTICATE (8388608 (0x800000))

ADsOpenObject を呼び出すときに、セキュリティで保護された認証が必要ないことを示します。

DSBI_RETURNOBJECTCLASS (16777216 (0x1000000))

pszObjectClass と cchObjectClass が有効であり、入力する必要があることを示します。

DSBI_DONTSIGNSEAL (33554432 (0x2000000))

ディレクトリサービスとの通信時に署名とシールが使用されないことを示します。

pfnCallback

コンテナーブラウザーダイアログボックスから通知を受信するアプリケーション定義の BFFCallBack コールバック関数へのポインター。このメンバーを使用しない場合は NULL に 設定します。

lParam

pfnCallback のすべての呼び出しで lpData パラメーターとして渡されるアプリケーション定義の 32 ビット値が含まれます。 pfnCallback が NULL の場合、このメンバーは無視されます。

dwReturnFormat

pszPath で返される ADSI パスが受け入れる形式を指定するADS_FORMAT_ENUM値のいずれかが含まれます。

pUserName

資格情報に使用されるユーザー名を含む Unicode 文字列へのポインター。 dwFlags に DSBI_HASCREDENTIALS フラグが設定されていない場合、このメンバーは無視されます。このメンバーが NULL の場合は、現在ログオンしているユーザー名が使用されます。

pPassword

資格情報に使用されるパスワードを含む Unicode 文字列へのポインター。 dwFlags に DSBI_HASCREDENTIALS フラグが設定されていない場合、このメンバーは無視されます。このメンバーが NULL の場合は、現在ログオンしているユーザーのパスワードが使用されます。

pszObjectClass

選択したのクラス文字列を受け取る Unicode 文字列バッファーへのポインター。 dwFlags に DSBI_RETURNOBJECTCLASS フラグが設定されていない場合、このメンバーは無視されます。

cchObjectClass

pszObjectClass バッファーのサイズを WCHAR 文字で格納します。

解説

注意

dsclient.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして DSBROWSEINFO を定義します。エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイムエラーが発生する不一致が発生する可能性があります。詳細については、「関数プロトタイプの規則」を参照してください。

要件


サポートされている最小のクライアント	Windows Vista
サポートされている最小のサーバー	Windows Server 2008
Header	dsclient.h

次の方法で共有