次の方法で共有

DSBITEMA 構造体 (dsclient.h)

  • [アーティクル]

DSBITEM 構造体には、Active Directory コンテナー ブラウザー ダイアログ ボックスの項目に関するデータが含まれています。 この構造体は、 DSBM_QUERYINSERT 通知と共に BFFCallBack コールバック関数に渡されます。 コンテナー ブラウザー ダイアログ ボックスは、 DsBrowseForContainer 関数を使用して作成されます。

構文

typedef struct {
  DWORD   cbStruct;
  LPCWSTR pszADsPath;
  LPCWSTR pszClass;
  DWORD   dwMask;
  DWORD   dwState;
  DWORD   dwStateMask;
  CHAR    szDisplayName[DSB_MAX_DISPLAYNAME_CHARS];
  CHAR    szIconLocation[MAX_PATH];
  INT     iIconResID;
} DSBITEMA, *PDSBITEMA;

メンバー

cbStruct

構造体のサイズをバイト単位で格納します。

pszADsPath

アイテムの ADsPath を含む null で終わる Unicode 文字列へのポインター。

pszClass

アイテムのオブジェクト クラス名を含む null で終わる Unicode 文字列へのポインター。

dwMask

構造体のどのメンバーに有効なデータが含まれているかを示すフラグのセットが含まれます。 これは、0 または次の値の 1 つ以上の組み合わせにすることができます。

DSBF_DISPLAYNAME

szDisplayName メンバーには有効なデータが含まれています。

DSBF_ICONLOCATION

szIconLocation メンバーと iIconResID メンバーには、有効なデータが含まれています。

DSBF_STATE

dwState メンバーと dwStateMask メンバーには、有効なデータが含まれています。

dwState

項目の状態を示すフラグのセットが含まれます。 これは、0 または次の値の 1 つ以上の組み合わせにすることができます。

DSBS_CHECKED

このフラグが設定されている場合は、項目が選択されます。 それ以外の場合、項目は選択されません。 このフラグは現在サポートされていません。

DSBS_HIDDEN

このフラグが設定されている場合、項目は非表示になります。 それ以外の場合は、項目が表示されます。

DSBS_ROOT

このフラグが設定されている場合、項目はルート項目です。 それ以外の場合、項目はルート項目ではありません。

dwStateMask

dwState メンバー内のどのフラグに有効なデータが含まれているかを示す一連のフラグが含まれます。 これは、0 または次の値の 1 つ以上の組み合わせにすることができます。 たとえば、 dwStateMask に DSBS_HIDDEN フラグが設定されていて、 dwState に DSBS_HIDDEN フラグが設定されていない場合、アイテムは表示されます。 dwStateMask にDSBS_HIDDEN フラグが設定されていない場合、dwState のDSBS_HIDDEN フラグは無視する必要があります。

DSBS_CHECKED

dwState メンバーのDSBS_CHECKED フラグには、有効なデータが含まれています。

DSBS_HIDDEN

dwState メンバーのDSBS_HIDDEN フラグには、有効なデータが含まれています。

DSBS_ROOT

dwState メンバーのDSBS_ROOT フラグには、有効なデータが含まれています。

szDisplayName[DSB_MAX_DISPLAYNAME_CHARS]

アイテムの表示名を含む null で終わる文字列へのポインター。 アイテムの表示名は、新しい表示名をこのメンバーにコピーし、dwMask メンバーに DSBF_DISPLAYNAME フラグを設定し、BFFCallBack から 0 以外の値を返すことで変更できます。

szIconLocation[MAX_PATH]

アイテムに表示するアイコンを含む .exe、.dll、または.ico ファイルの名前を含む null で終わる文字列へのポインター。 ExtractIcon 関数に渡すことができる任意のファイルの種類を指定できます。 このアイコンのインデックスは iIconResID で指定されます。 アイテムに表示されるアイコンを変更するには、アイコン ソース ファイル名をこのメンバーにコピーし、iIconResID をアイコンの 0 から始まるインデックスに設定し、dwMask メンバーに DSBF_ICONLOCATION フラグを設定し、BFFCallBack から 0 以外の値を返します。

iIconResID

アイテムに表示するアイコンの 0 から始まるインデックスが含まれます。

メモ これはアイコンのリソース識別子ではありません。
 

注釈

注意

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

要件

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

こちらもご覧ください

BFFCallBack

DsBrowseForContainer

ExtractIcon