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 値へのポインター。 この状態は、BSSF_VISIBLE、BSSF_NOTITLE、BSSF_UNDELETEABLEの組み合わせです。 これらのフラグの詳細については、「 BANDSITEINFO 」を参照してください。 状態情報が不要な場合は、この値を NULL にすることができます 。

[out] pszName

種類: LPWSTR

このメソッドが正常に返されたときにバンド オブジェクトの名前を受け取る cchName Unicode 文字のバッファーへのポインター。

[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 以降)