Metode IShellExtInit::Initialize (shobjidl_core.h)

  • Artikel

Menginisialisasi ekstensi lembar properti, ekstensi menu pintasan, atau penangan seret dan letakkan.

Sintaks

HRESULT Initialize(
  [in] PCIDLIST_ABSOLUTE pidlFolder,
  [in] IDataObject       *pdtobj,
  [in] HKEY              hkeyProgID
);

Parameter

[in] pidlFolder

Jenis: PCIDLIST_ABSOLUTE

Penunjuk ke struktur ITEMIDLIST yang secara unik mengidentifikasi folder. Untuk ekstensi lembar properti, parameter ini adalah NULL. Untuk ekstensi menu pintasan, ini adalah daftar pengidentifikasi item untuk folder yang berisi item yang menu pintasannya sedang ditampilkan. Untuk ekstensi menu seret dan letakkan nondefault, parameter ini menentukan folder target.

[in] pdtobj

Jenis: IDataObject*

Penunjuk ke objek antarmuka IDataObject yang dapat digunakan untuk mengambil objek yang ditindaklanjuti.

[in] hkeyProgID

Jenis: HKEY

Kunci registri untuk objek file atau jenis folder.

Nilai kembali

Jenis: HRESULT

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

Keterangan

Arti dari beberapa parameter tergantung pada jenis ekstensi. Untuk penangan seret dan letakkan, parameter pidlFolder menentukan folder tujuan (target penghilangan), parameter pdtobj mengidentifikasi item yang dihilangkan, dan parameter hkeyProgID menentukan jenis file folder tujuan.

Untuk ekstensi menu pintasan, pdtobj mengidentifikasi objek file yang dipilih, hkeyProgID mengidentifikasi tipe file objek dengan fokus, dan pidlFolder adalah NULL (untuk objek file) atau menentukan folder tempat menu pintasan diminta (untuk menu pintasan latar belakang folder).

Untuk ekstensi lembar properti, pidlFolder adalah NULL, pdtobj mengidentifikasi objek file yang dipilih, dan hkeyProgID menentukan jenis file objek file yang memiliki fokus.

Catatan untuk Pelaksana

Ini adalah metode pertama yang dipanggil Shell setelah membuat instans ekstensi lembar properti, ekstensi menu pintasan, atau penangan seret dan letakkan.

Persyaratan

   
Klien minimum yang didukung Windows XP [hanya aplikasi desktop]
Server minimum yang didukung Windows 2000 Server [hanya aplikasi desktop]
Target Platform Windows
Header shobjidl_core.h (termasuk Shobjidl.h)
DLL Shell32.dll (versi 4.0 atau yang lebih baru)