Fungsi SHCreateShellFolderView (shlobj_core.h)

Artikel
03/04/2024

Membuat instans baru objek tampilan folder Shell default (DefView).

Sintaks

SHSTDAPI SHCreateShellFolderView(
  [in]  const SFV_CREATE *pcsfv,
  [out] IShellView       **ppsv
);

Parameter

[in] pcsfv

Jenis: const SFV_CREATE*

Arahkan ke struktur SFV_CREATE yang menjelaskan detail yang digunakan dalam membuat instans objek tampilan folder Shell ini.

[out] ppsv

Jenis: IShellView**

Ketika fungsi ini berhasil dikembalikan, berisi penunjuk antarmuka ke objek IShellView baru. Jika gagal, nilai ini ADALAH NULL.

Nilai kembali

Jenis: HRESULT

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

Keterangan

SHCreateShellFolderView direkomendasikan melalui SHCreateShellFolderViewEx karena fleksibilitas yang lebih besar dari elemen-elemennya untuk berpartisipasi dalam berbagai skenario, menyediakan fungsionalitas baru untuk tampilan, dan berinteraksi dengan objek lain.

Saat berhadapan dengan beberapa instans IShellView, Anda mungkin ingin memverifikasi mana yang merupakan objek tampilan folder Shell default. Untuk melakukannya, panggil QueryInterface pada objek menggunakan IID IID_CDefView. Panggilan ini hanya berhasil ketika dilakukan pada objek tampilan folder Shell default.

Sumber data yang menggunakan objek tampilan folder Shell default harus mengimplementasikan antarmuka ini:

Secara opsional, mereka juga dapat mengimplementasikan IPersistFolder3.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	shlobj_core.h (termasuk Shlobj.h)
Pustaka	Shell32.lib
DLL	Shell32.dll (versi 5.0 atau yang lebih baru)
Set API	ext-ms-win-shell-shell32-l1-2-2 (diperkenalkan dalam Windows 10, versi 10.0.14393)

Lihat juga

SFV_CREATE

SHCreateShellFolderViewEx

Bagikan melalui