IShellFolder::GetUIObjectOf メソッド (shobjidl_core.h)

指定したファイル オブジェクトまたはフォルダーに対してアクションを実行するために使用できるオブジェクトを取得します。

構文

HRESULT GetUIObjectOf(
  [in]      HWND                  hwndOwner,
  [in]      UINT                  cidl,
  [in]      PCUITEMID_CHILD_ARRAY apidl,
  [in]      REFIID                riid,
  [in, out] UINT                  *rgfReserved,
  [out]     void                  **ppv
);

パラメーター

[in] hwndOwner

型: HWND

ダイアログ ボックスまたはメッセージ ボックスを表示するかどうかをクライアントが指定する必要がある所有者ウィンドウへのハンドル。

[in] cidl

型: UINT

apidl パラメーターで指定されたファイル オブジェクトまたはサブフォルダーの数。

[in] apidl

種類: PCUITEMID_CHILD_ARRAY

ITEMIDLIST 構造体へのポインターの配列のアドレス。それぞれのアドレスは、親フォルダーを基準にしてファイル オブジェクトまたはサブフォルダーを一意に識別します。 各項目 ID リストには、1 つの SHITEMID 構造体の後に終了ゼロが続く必要があります。

[in] riid

種類: REFIID

ppv を介して取得するインターフェイスの IID への参照。 これは、アイテムに対して作成できる任意の有効なインターフェイス識別子です。 シェルで使用される最も一般的な識別子は、この参照の最後にあるコメントに一覧表示されます。

[in, out] rgfReserved

種類: UINT*

予約済み。

[out] ppv

型: void**

このメソッドが正常に返されると、 には riid で要求されたインターフェイス ポインターが含まれます。

戻り値

種類: HRESULT

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

注釈

cidl が 1 より大きい場合、IShellFolder::GetUIObjectOf の実装は、apidl で指定されたすべての項目に対して 1 つのオブジェクトを作成できる場合にのみ成功する必要があります。 実装ですべての項目に対して 1 つのオブジェクトを作成できない場合、このメソッドは失敗します。

シェルがこのメソッドからインターフェイスを要求するときに使用する最も一般的なインターフェイス識別子を次に示します。 また、要求されたインターフェイスに 対して cidl を 1 より大きくできるかどうかを示します。

インターフェイス識別子	使用できる cidl 値
IContextMenu	cidl パラメーターは、1 以上にすることができます。
IContextMenu2	cidl パラメーターは、1 以上にすることができます。
Idataobject	cidl パラメーターは、1 以上にすることができます。
IDropTarget	cidl パラメーターは 1 つだけ指定できます。
IExtractIcon	cidl パラメーターは 1 つだけ指定できます。
IQueryInfo	cidl パラメーターは 1 つだけ指定できます。

 

riid パラメーターと ppv パラメーターをパッケージ化するには、Objbase.h で定義されている IID_PPV_ARGS マクロを使用することをお勧めします。 このマクロは 、ppv の値によって指されるインターフェイスに基づいて正しい IID を提供します。これにより、 riid でコーディング エラーが発生し、予期しない結果が発生する可能性がなくなります。

要件

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

こちらもご覧ください

IShellFolder

IShellFolder2