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 |