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

要查詢的帶狀物件識別碼。

[out, optional] ppstb

類型： IDeskBand**

IDeskBand介面指標的位址，當此方法成功傳回時，會指向代表訊號範圍的IDeskBand物件。 此值可以是 Null。

[out, optional] pdwState

類型： DWORD*

DWORD值的指標，當這個方法成功傳回時，會接收帶狀物件的狀態。 此狀態是BSSF_VISIBLE、BSSF_NOTITLE和BSSF_UNDELETEABLE的組合。 如需這些旗標的詳細資訊，請參閱 BANDSITEINFO 。 如果不需要狀態資訊，此值可以是 Null 。

[out] pszName

類型： LPWSTR

cchName Unicode 字元緩衝區的指標，當這個方法成功傳回時，會收到帶狀區物件的名稱。

[in] cchName

類型： int

pszName緩衝區的大小，以字元為單位。

傳回值

類型： HRESULT

如果此方法成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

規格需求

最低支援的用戶端	Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平台	Windows
標頭	shobjidl_core.h (包含 Shldisp.h)
Dll	Shell32.dll (4.71 版或更新版本)