Fungsi SHCreateShellItemArrayFromDataObject (shobjidl_core.h)

Artikel
08/26/2023

Membuat objek array item Shell dari objek data.

Sintaks

SHSTDAPI SHCreateShellItemArrayFromDataObject(
  [in]  IDataObject *pdo,
  [in]  REFIID      riid,
  [out] void        **ppv
);

Parameter

[in] pdo

Jenis: IDataObject*

Penunjuk ke antarmuka IDataObject .

[in] riid

Jenis: REFIID

Referensi ke ID antarmuka yang diinginkan.

[out] ppv

Jenis: void**

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

Nilai kembali

Jenis: HRESULT

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

Keterangan

Fungsi ini berguna untuk ekstensi Shell yang mengimplementasikan IShellExtInit dan diteruskan objek data ke metode IShellExtInit::Initialize ; misalnya, penangan menu konteks.

API ini memungkinkan Anda mengonversi objek data menjadi item Shell yang dapat dikonsumsi oleh handler. Disarankan agar handler menggunakan array item Shell daripada format clipboard seperti CF_HDROP dan CFSTR_SHELLIDLIST (juga dikenal sebagai HIDA) karena mengarah ke kode yang lebih sederhana dan memungkinkan beberapa peningkatan performa.

Array item shell yang dihasilkan menyimpan referensi ke objek data sumber. Oleh karena itu, objek data tersebut harus tetap valid selama masa pakai array item shell. Terutama, objek data yang diteruskan ke metode IDropTarget tidak lagi valid setelah operasi penghilangan selesai.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	shobjidl_core.h (termasuk Shobjidl.h)
DLL	Shell32.dll
Set API	ext-ms-win-shell-shell32-l1-2-2 (diperkenalkan dalam Windows 10, versi 10.0.14393)