IBandSite::QueryBand 方法 (shobjidl_core.h)

获取有关乐队站点中带区的信息。

语法

HRESULT QueryBand(
  [in]            DWORD     dwBandID,
  [out, optional] IDeskBand **ppstb,
  [out, optional] DWORD     *pdwState,
  [out]           LPWSTR    pszName,
  [in]            int       cchName
);

参数

[in] dwBandID

类型:DWORD

要查询的带对象的 ID。

[out, optional] ppstb

类型: IDeskBand**

IDeskBand 接口指针的地址,当此方法成功返回时,该指针指向表示波段的 IDeskBand 对象。 此值可以为 NULL

[out, optional] pdwState

类型: DWORD*

指向 DWORD 值的指针,此方法成功返回时,该值接收 band 对象的状态。 此状态是BSSF_VISIBLE、BSSF_NOTITLE和BSSF_UNDELETEABLE的组合。 有关这些标志的详细信息,请参阅 BANDSITEINFO 。 如果不需要状态信息,此值可以为 NULL

[out] pszName

类型: LPWSTR

指向 cchName Unicode 字符缓冲区的指针,此方法成功返回时接收 band 对象的名称。

[in] cchName

类型: int

pszName 缓冲区的大小(以字符为单位)。

返回值

类型: HRESULT

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

要求

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