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