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 或更高版本)