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
包含一組旗標，指出結構的哪些成員包含有效的數據。 這可以是零或下列一或多個值的組合。
DSBF_DISPLAYNAME
szDisplayName 成員包含有效的數據。
DSBF_ICONLOCATION
szIconLocation 和 iIconResID 成員包含有效的數據。
DSBF_STATE
dwState 和dwStateMask 成員包含有效的數據。
dwState
包含一組旗標，指出項目的狀態。 這可以是零或下列一或多個值的組合。
DSBS_CHECKED
如果設定此旗標，則會選取專案。 否則，不會選取專案。 目前不支援此旗標。
DSBS_HIDDEN
如果已設定此旗標，則會隱藏專案。 否則，項目會顯示。
DSBS_ROOT
如果設定此旗標，專案就是根專案。 否則，專案不是根專案。
dwStateMask
包含一組旗標，指出 dwState 成員中的哪些旗標包含有效的數據。 這可以是零或下列一或多個值的組合。 例如，如果 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 傳回非零值，以變更項目的顯示名稱。
szIconLocation[MAX_PATH]
Null 終止字串的指標，其中包含要顯示專案之圖示的 .exe、.dll 或.ico檔案。 這可以是可以傳遞至 ExtractIcon 函式的任何文件類型。 此圖示的索引是在 iIconResID 中指定。 若要修改項目顯示的圖示，請將圖示來源檔名複製到此成員、將 iIconResID 設定為圖示的以零起始的索引、在 dwMask 成員中設定DSBF_ICONLOCATION旗標，並從 BFFCallBack 傳回非零值。
iIconResID
包含要針對項目顯示之圖示之以零起始的索引。
備註
注意
dsclient.h 標頭會將 DSBITEM 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱 函式原型的慣例。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows Vista |
| 最低支援的伺服器 | Windows Server 2008 |
| 標頭 | dsclient.h |