Metode IPersistFolder::Initialize (shobjidl_core.h)

Artikel
03/02/2024

Menginstruksikan objek folder Shell untuk menginisialisasi dirinya sendiri berdasarkan informasi yang diteruskan.

Sintaks

HRESULT Initialize(
  PCIDLIST_ABSOLUTE pidl
);

Parameter

pidl

Jenis: LPCITEMIDLIST

Alamat struktur ITEMIDLIST (daftar pengidentifikasi item) yang menentukan lokasi absolut folder.

Nilai kembali

Jenis: HRESULT

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

Keterangan

Semua objek yang mengimplementasikan antarmuka IShellFolder untuk digunakan di namespace Shell harus menerapkan metode ini. Ketika lokasi folder di namespace tidak menjadi pertimbangan yang relevan, metode ini cukup mengembalikan S_OK. Ketika lokasi relevan dengan folder, Anda harus menyimpan IDLIST yang sepenuhnya memenuhi syarat yang diteruskan untuk referensi nanti.

Misalnya, jika implementasi folder perlu membuat penunjuk yang sepenuhnya memenuhi syarat ke daftar pengidentifikasi item (PIDL) ke elemen yang dikandungnya, PIDL yang diteruskan ke metode ini harus digunakan untuk membangun PIDL yang sepenuhnya memenuhi syarat.

Persyaratan

Persyaratan	Nilai
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)

Bagikan melalui