Fungsi SHGetItemFromDataObject (shobjidl_core.h)

Artikel
03/02/2024

Membuat IShellItem atau objek terkait berdasarkan item yang ditentukan oleh IDataObject.

Sintaks

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

Parameter

[in] pdtobj

Jenis: IDataObject*

Penunjuk ke instans IDataObject sumber.

[in] dwFlags

Jenis: DATAOBJ_GET_ITEM_FLAGS

Satu atau beberapa nilai dari enumerasi DATAOBJ_GET_ITEM_FLAGS untuk menentukan opsi mengenai objek target. Nilai ini bisa 0.

[in] riid

Jenis: REFIID

Referensi ke IID antarmuka untuk diambil melalui ppv, biasanya IID_IShellItem.

[out] ppv

Jenis: void**

Ketika metode ini kembali, berisi pointer antarmuka yang diminta dalam riid. Ini biasanya IShellItem.

Nilai kembali

Jenis: HRESULT

Jika fungsi ini berhasil, fungsi akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Disarankan agar Anda menggunakan makro IID_PPV_ARGS , yang didefinisikan dalam Objbase.h, untuk mengemas parameter riid dan ppv . Makro ini menyediakan IID yang benar berdasarkan antarmuka yang diacu oleh nilai dalam ppv, yang menghilangkan kemungkinan kesalahan pengkodian.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 R2 [hanya aplikasi desktop]
Target Platform	Windows
Header	shobjidl_core.h (termasuk Shobjidl.h)
DLL	Shell32.dll (versi 6.1 atau yang lebih baru)

Bagikan melalui