DSBROWSEINFOA 構造体 (dsclient.h)

[アーティクル]
11/20/2024

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
ヘッダー	dsclient.h

次の方法で共有