次の方法で共有

DSBITEMA 構造体 (dsclient.h)

  • [アーティクル]

DSBITEM 構造体には、Active Directory コンテナー ブラウザー ダイアログ ボックスの項目に関するデータが含まれています。 この構造体は、BFFCallBack コールバック関数に DSBM_QUERYINSERT 通知と共に渡されます。 コンテナー ブラウザー ダイアログ ボックスは、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 を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。

必要条件

要件 価値
サポートされる最小クライアント Windows Vista
サポートされる最小サーバー Windows Server 2008
ヘッダー dsclient.h

関連項目

BFFCallBack の

DsBrowseForContainer の

ExtractIcon