通过

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