Fungsi StgCreatePropStg (coml2api.h)

Artikel
08/22/2023

Fungsi StgCreatePropStg membuat dan membuka properti yang diatur dalam penyimpanan atau objek stream tertentu. Set properti memasok implementasi antarmuka IPropertyStorage yang disediakan sistem dan berdiri sendiri.

Sintaks

HRESULT StgCreatePropStg(
  [in]  IUnknown         *pUnk,
  [in]  REFFMTID         fmtid,
  [in]  const CLSID      *pclsid,
  [in]  DWORD            grfFlags,
  [in]  DWORD            dwReserved,
  [out] IPropertyStorage **ppPropStg
);

Parameter

[in] pUnk

Penunjuk ke antarmuka IUnknown pada objek penyimpanan atau aliran yang menyimpan kumpulan properti baru.

[in] fmtid

FMTID properti yang diatur untuk dibuat.

[in] pclsid

Pointer ke CLSID awal untuk set properti ini. Mungkin NULL, dalam hal ini pclsid diatur ke semua nol.

[in] grfFlags

Nilai dari PROPSETFLAG Constants yang menentukan bagaimana kumpulan properti dibuat dan dibuka.

[in] dwReserved

Dipesan; harus nol.

[out] ppPropStg

Alamat variabel pointer IPropertyStorage* yang menerima penunjuk antarmuka ke set properti baru.

Nilai kembali

Fungsi ini mendukung nilai pengembalian standar E_INVALIDARG dan E_UNEXPECTED, selain yang berikut:

Keterangan

StgCreatePropStg membuat dan membuka set properti baru yang memasok implementasi antarmuka IPropertyStorage yang disediakan sistem dan mandiri. Kumpulan properti baru terkandung dalam objek penyimpanan atau aliran yang ditentukan oleh pUnk. Nilai parameter grfFlags menunjukkan apakah pUnk menentukan penyimpanan atau objek streaming. Misalnya, jika PROPSETFLAG_NONSIMPLE diatur, maka pUnk dapat dikueri untuk antarmuka IStorage pada objek penyimpanan.

Dalam kedua kasus, fungsi ini memanggil pUnk-AddRef> untuk penyimpanan atau objek streaming yang berisi kumpulan properti. Pemanggil bertanggung jawab untuk melepaskan objek ketika tidak lagi diperlukan.

Fungsi ini mirip dengan metode IPropertySetStorage::Create . Namun, StgCreatePropStg menambahkan parameter pUnk dan mendukung nilai PROPSETFLAG_UNBUFFERED untuk parameter grfFlags . Gunakan fungsi ini alih-alih metode Buat jika Anda memiliki antarmuka IStorage yang tidak mendukung antarmuka IPropertySetStorage , atau jika Anda ingin menggunakan nilai PROPSETFLAG_UNBUFFERED. Untuk informasi selengkapnya tentang menggunakan nilai enumerasi PROPSETFLAG_UNBUFFERED ini, lihat PROPSETFLAG Constants.

Kumpulan properti secara otomatis berisi halaman kode dan properti pengidentifikasi lokal (ID). Ini diatur ke default sistem saat ini dan default pengguna saat ini, masing-masing.

Parameter grfFlags adalah kombinasi nilai yang diambil dari PROPSETFLAG Constants. Nilai enumerasi baru PROPSETFLAG_UNBUFFERED didukung. Untuk informasi selengkapnya, lihat PROPSETFLAG Constants.

Fungsi ini diekspor dari Iprop.dll yang dapat didistribusikan ulang, yang disertakan dalam Windows NT 4.0 dengan Paket Layanan 2 (SP2) dan yang lebih baru dan tersedia sebagai yang dapat didistribusikan kembali di Windows 95, Windows 98 dan yang lebih baru. Di Windows 2000 dan Windows XP, itu diekspor dari ole32.dll. Ini juga dapat diekspor dari iprop.dll di Windows 2000 dan Windows XP, tetapi panggilan diteruskan ke ole32.dll.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows 2000 Server [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	coml2api.h (termasuk Propidl.h)
Pustaka	Ole32.lib
DLL	Ole32.dll