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

另請參閱

BFFCallBack

DsBrowseForContainer

ExtractIcon