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

要透過 ppv 擷取之介面 IID 的參考，通常IID_IShellItem。

[out] ppv

類型： void**

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

傳回值

類型： HRESULT

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

備註

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

規格需求

需求 值
最低支援的用戶端 Windows 7 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 R2 [僅限傳統型應用程式]
目標平台 Windows
標頭 shobjidl_core.h (包括 Shobjidl.h)
Dll Shell32.dll (6.1 版或更新版本)