IDeskBand：：GetBandInfo 方法 (shobjidl_core.h)

  • 项目

获取带对象的状态信息。

重要 应在新开发中使用 缩略图工具栏 来代替桌面带，因为从 Windows 7 开始不支持这些带。
 

语法

HRESULT GetBandInfo(
  DWORD        dwBandID,
  DWORD        dwViewMode,
  DESKBANDINFO *pdbi
);

参数

dwBandID

类型：DWORD

由容器分配的带的标识符。 如果需要，band 对象可以保留此值。

dwViewMode

类型：DWORD

带对象的视图模式。 以下值之一：

DBIF_VIEWMODE_NORMAL

带对象正在水平带中显示。

DBIF_VIEWMODE_VERTICAL

带对象正在垂直带中显示。

DBIF_VIEWMODE_FLOATING

波段对象显示在浮动带中。

DBIF_VIEWMODE_TRANSPARENT

带对象显示在透明带中。

pdbi

类型： DESKBANDINFO*

指向接收对象的带信息的 DESKBANDINFO 结构的指针。 此结构的 dwMask 成员指示正在请求的特定信息。

返回值

类型： HRESULT

如果该方法成功，则返回 S_OK。 否则，将返回 HRESULT 错误代码。

要求

要求 值
最低受支持的客户端 Windows 2000 专业版、Windows XP [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 shobjidl_core.h (包括 Shlobj.h)
DLL Shell32.dll (版本 4.71 或更高版本)