SHGetItemFromDataObject 関数 (shobjidl_core.h)

IDataObject で指定された項目に基づいて 、IShellItem または関連オブジェクトを作成 します。

構文

HRESULT SHGetItemFromDataObject(
  [in]  IDataObject            *pdtobj,
  [in]  DATAOBJ_GET_ITEM_FLAGS dwFlags,
  [in]  REFIID                 riid,
  [out] void                   **ppv
);

パラメーター

[in] pdtobj

型: IDataObject*

ソース IDataObject インスタンスへのポインター。

[in] dwFlags

種類: DATAOBJ_GET_ITEM_FLAGS

ターゲット オブジェクトに関するオプションを指定するための 、DATAOBJ_GET_ITEM_FLAGS 列挙の 1 つ以上の値。 この値は 0 にできます。

[in] riid

型: REFIID

ppv を介して取得するインターフェイスの IID への参照 。通常はIID_IShellItem。

[out] ppv

型: void**

このメソッドから制御が戻るときに、 riid で要求されたインターフェイス ポインターが格納されます。 これは通常 、IShellItem です。

戻り値

型: HRESULT

この関数が成功すると、 S_OKが返されます。 そうでない場合は、HRESULT エラー コードを返します。

注釈

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

要件

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