IShellMenu::GetShellFolder メソッド (shobjidl_core.h)

  • [アーティクル]

メニュー バンドが参照するように設定されているフォルダーを取得します。

構文

HRESULT GetShellFolder(
  [out] DWORD            *pdwFlags,
  [out] PIDLIST_ABSOLUTE *ppidl,
  [in]  REFIID           riid,
  [out] void             **ppv
);

パラメーター

[out] pdwFlags

種類: DWORD*

このメソッドが正常に返されると、 には、メニュー バンドの動作方法を指定するフラグ値のセットへのポインターが含まれます。

次のいずれかのフラグを返すことができます。

値 意味
SMINIT_DEFAULT
 オプションなし。
SMINIT_RESTRICT_DRAGDROP
 ドラッグ アンド ドロップは許可しません。
SMINIT_TOPLEVEL
 これはトップ バンドです。
SMINIT_CACHED
 ウィンドウを閉じるときにバンドを破棄しないでください。
 

常に、次のいずれかのフラグを返します。

値 意味
SMINIT_VERTICAL
 垂直バンドを指定します。
SMINIT_HORIZONTAL
 水平方向のバンドを指定します。

[out] ppidl

種類: PCIDLIST_ABSOLUTE*

このメソッドが返されると、 にはフォルダーの完全修飾 ITEMIDLIST のアドレスが含まれます。

[in] riid

種類: REFIID

ターゲット フォルダーの REFIID。

[out] ppv

型: void**

このメソッドが正常に返されると、 riid によって参照されるシェル フォルダー オブジェクトへのポインターのアドレスが格納されます。

戻り値

種類: HRESULT

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

要件

要件 値
サポートされている最小のクライアント WINDOWS XP と SP2 [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー shobjidl_core.h (Shobjidl.h を含む)
[DLL] Shell32.dll