Metode IPersistFolder3::InitializeEx (shobjidl_core.h)

Artikel
2024-03-04

Menginisialisasi folder dan menentukan lokasinya di namespace. Jika folder adalah pintasan, metode ini juga menentukan lokasi folder target.

Sintaks

HRESULT InitializeEx(
  [in] IBindCtx                         *pbc,
  [in] PCIDLIST_ABSOLUTE                pidlRoot,
  [in] const PERSIST_FOLDER_TARGET_INFO *ppfti
);

Parameter

[in] pbc

Jenis: IBindCtx*

Penunjuk ke objek IBindCtx yang menyediakan konteks ikatan. Parameter ini bisa NULL.

[in] pidlRoot

Jenis: LPCITEMIDLIST

Penunjuk ke PIDL yang sepenuhnya memenuhi syarat yang menentukan lokasi absolut folder atau pintasan folder. Aplikasi panggilan bertanggung jawab untuk mengalokasikan dan membebaskan PIDL ini.

[in] ppfti

Jenis: const PERSIST_FOLDER_TARGET_INFO*

Penunjuk ke struktur PERSIST_FOLDER_TARGET_INFO yang menentukan lokasi folder target dan atributnya.

Jika ppfti menunjuk ke struktur yang valid, pidlRoot mewakili pintasan folder.

Jika ppfti diatur ke NULL, pidlRoot mewakili folder normal. Dalam hal ini, InitializeEx harus berperilaku seolah-olah Inisialisasi telah dipanggil.

Mengembalikan nilai

Jenis: HRESULT

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

Keterangan

Fungsi ini adalah versi yang diperluas dari IPersistFolder::Initialize. Ini memungkinkan Shell untuk menginisialisasi pintasan folder serta folder normal.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional dengan SP3, Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	shobjidl_core.h (termasuk Shobjidl.h)
DLL	Shell32.dll (versi 5.0 atau yang lebih baru)

Bagikan melalui