Metode IShellItem2::GetPropertyStoreWithCreateObject (shobjidl_core.h)

Artikel
03/04/2024

Menggunakan ICreateObject yang ditentukan alih-alih CoCreateInstance untuk membuat instans handler properti yang terkait dengan item Shell tempat metode ini dipanggil. Sebagian besar aplikasi panggilan tidak perlu memanggil metode ini, dan dapat memanggil IShellItem2::GetPropertyStore sebagai gantinya.

Sintaks

HRESULT GetPropertyStoreWithCreateObject(
  [in]  GETPROPERTYSTOREFLAGS flags,
  [in]  IUnknown              *punkCreateObject,
  [in]  REFIID                riid,
  [out] void                  **ppv
);

Parameter

[in] flags

Jenis: GETPROPERTYSTOREFLAGS

Konstanta GETPROPERTYSTOREFLAGS yang memodifikasi objek penyimpanan properti.

[in] punkCreateObject

Jenis: IUnknown*

Penunjuk ke pabrik untuk pembuatan hak rendah jenis ICreateObject.

Metode CreateObject membuat instans objek COM. Implementasi IShellItem2::GetPropertyStoreWithCreateObject menggunakan CreateObject alih-alih CoCreateInstance untuk membuat handler properti, yang merupakan ekstensi Shell, untuk jenis file tertentu. Handler properti menyediakan banyak properti penting di penyimpanan properti yang dikembalikan metode ini.

Metode ini hanya berguna jika objek ICreateObject dibuat dalam proses terpisah (sebagai LOCALSERVER alih-alih INPROCSERVER), dan juga jika proses lain ini memiliki hak yang lebih rendah daripada proses memanggil IShellItem2::GetPropertyStoreWithCreateObject.

[in] riid

Jenis: REFIID

Referensi ke IID objek yang akan diambil.

[out] ppv

Jenis: void**

Ketika metode ini kembali, berisi alamat penunjuk antarmuka IPropertyStore yang diminta.

Mengembalikan nilai

Jenis: HRESULT

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

Keterangan

Catatan Ketika metode ini dipanggil pada penyimpanan properti untuk file, file tersebut ditahan terbuka selama masa pakai objek IPropertyStore .

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	shobjidl_core.h (termasuk Shobjidl.h)

Bagikan melalui