共用方式為

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