Metode IShellFolder::CreateViewObject (shobjidl_core.h)

Artikel
08/26/2023

Meminta objek yang dapat digunakan untuk mendapatkan informasi dari atau berinteraksi dengan objek folder.

Sintaks

HRESULT CreateViewObject(
  [in]  HWND   hwndOwner,
  [in]  REFIID riid,
  [out] void   **ppv
);

Parameter

[in] hwndOwner

Jenis: HWND

Handel ke jendela pemilik. Jika Anda telah menerapkan objek tampilan folder kustom, jendela tampilan folder Anda harus dibuat sebagai anak dari hwndOwner.

[in] riid

Jenis: REFIID

Referensi ke IID antarmuka untuk diambil melalui ppv, biasanya IID_IShellView.

[out] ppv

Jenis: batal**

Ketika metode ini berhasil dikembalikan, berisi pointer antarmuka yang diminta dalam riid. Ini biasanya IShellView. Lihat bagian Keterangan untuk detail selengkapnya.

Nilai kembali

Jenis: HRESULT

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

Keterangan

Untuk mendukung permintaan ini, buat objek yang mengekspos antarmuka yang ditunjukkan oleh riid dan kembalikan pointer ke antarmuka tersebut.

Tujuan utama metode ini adalah untuk menyediakan Windows Explorer dengan objek tampilan folder objek folder. Windows Explorer meminta objek tampilan folder dengan menyetel riid ke IID_IShellView. Objek tampilan folder menampilkan isi folder dalam tampilan folder Windows Explorer. Objek tampilan folder harus independen dari objek folder Shell, karena Windows Explorer mungkin memanggil metode ini lebih dari sekali untuk membuat beberapa objek tampilan folder. Objek tampilan baru harus dibuat setiap kali metode ini dipanggil. Objek folder Anda dapat merespons dengan salah satu dari dua cara untuk permintaan ini. Dapat digunakan untuk:

Buat objek tampilan folder kustom dan kembalikan penunjuk ke antarmuka IShellView-nya .
Buat objek tampilan folder sistem dan kembalikan penunjuk ke antarmuka IShellView-nya .

Metode ini juga digunakan untuk meminta objek yang mengekspos salah satu dari beberapa antarmuka opsional, termasuk IContextMenu atau IExtractIcon. Dalam konteks ini, CreateViewObject mirip dalam penggunaan IShellFolder::GetUIObjectOf. Namun, Anda memanggil IShellFolder::GetUIObjectOf untuk meminta objek untuk salah satu item yang dimuat oleh folder. Panggil IShellFolder::CreateViewObject untuk meminta objek untuk folder itu sendiri. Antarmuka yang paling umum diminta adalah:

Kami menyarankan agar Anda menggunakan makro IID_PPV_ARGS , yang ditentukan dalam Objbase.h, untuk mengemas parameter riid dan ppv . Makro ini menyediakan IID yang benar berdasarkan antarmuka yang ditunjukkan oleh nilai dalam ppv, yang menghilangkan kemungkinan kesalahan pengkodian dalam riid yang dapat menyebabkan hasil yang tidak terduga.

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)

Lihat juga

IShellFolder

IShellFolder2

Bagikan melalui