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列舉中的一或多個值，以指定目標物件的相關選項。 此值可以是 0。

[in] riid

類型： REFIID

對介面 IID 的參考，以透過 ppv 擷取，通常是IID_IShellItem。

[out] ppv

類型： 無效**

當這個方法傳回時，包含 riid 中要求的介面指標。 這通常是 IShellItem。

返回值

類型：HRESULT

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

備註

建議您使用 Objbase.h 中定義的 IID_PPV_ARGS 巨集來封裝 riid 和 ppv 參數。 此巨集會根據 ppv 中的值所指向的介面提供正確的 IID，這可消除編碼錯誤的可能性。

需求

Requirement	價值觀
最低支援的用戶端	Windows 7 [僅限桌面應用程式]
支援的最低伺服器	Windows Server 2008 R2 [僅限傳統型應用程式]
目標平臺	窗戶
Header	shobjidl_core.h（包括 Shobjidl.h）
Library	殼層32.lib
DLL	Shell32.dll（6.1 版或更高版本）