Metode IPropertyStoreFactory::GetPropertyStore (propsys.h)

Artikel
03/01/2024

Mendapatkan objek IPropertyStore yang sesuai dengan bendera yang disediakan.

Sintaks

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

Parameter

[in] flags

Jenis: GETPROPERTYSTOREFLAGS

Nilai GETPROPERTYSTOREFLAGS yang memodifikasi penyimpanan yang dikembalikan.

[in] pUnkFactory

Jenis: IUnknown*

Opsional. Penunjuk ke IUnknown objek yang mengimplementasikan ICreateObject. Jika pUnkFactory disediakan, metode ini dapat membuat instans handler menggunakan ICreateObject daripada CoCreateInstance, jika diimplementasikan. Alasan untuk menyediakan pUnkFactory biasanya untuk membuat handler dalam proses yang berbeda. Namun, untuk sebagian besar pengguna, melewati NULL dalam parameter ini sudah cukup.

[in] riid

Jenis: REFIID

Referensi ke IID objek yang akan dibuat.

[out] ppv

Jenis: batal**

Ketika metode ini kembali, berisi alamat penunjuk antarmuka IPropertyStore .

Nilai kembali

Jenis: HRESULT

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

Keterangan

Disarankan 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 ditujukkan oleh nilai dalam ppv, yang menghilangkan kemungkinan kesalahan pengkodian.

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	propsys.h

Bagikan melalui