Fungsi StgOpenPropStg (coml2api.h)

Artikel
02/24/2024

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

Sintaks

HRESULT StgOpenPropStg(
  [in]  IUnknown         *pUnk,
  [in]  REFFMTID         fmtid,
  [in]  DWORD            grfFlags,
  [in]  DWORD            dwReserved,
  [out] IPropertyStorage **ppPropStg
);

Parameter

[in] pUnk

Penunjuk antarmuka untuk antarmuka IUnknown pada penyimpanan atau objek streaming yang berisi objek set properti yang diminta.

[in] fmtid

FMTID properti yang diatur untuk dibuka.

[in] grfFlags

Nilai dari PROPSETFLAG Constants.

[in] dwReserved

Dicadangkan untuk digunakan di masa mendatang; harus nol.

[out] ppPropStg

Penunjuk ke variabel pointer IPropertyStorage* yang menerima penunjuk antarmuka ke set properti yang diminta.

Nilai kembali

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

Keterangan

StgOpenPropStg membuka set properti yang diminta dan menyediakan implementasi yang disediakan sistem dan berdiri sendiri dari antarmuka IPropertyStorage . Kumpulan properti yang diminta 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 set properti. Penelepon harus melepaskan objek ketika tidak lagi diperlukan.

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

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

Fungsi ini diekspor dari iprop.dll yang dapat didistribusikan ulang, yang termasuk dalam Windows NT 4.0 dengan Paket Layanan 2 (SP2) dan tersedia sebagai yang dapat didistribusikan ulang di Windows 95 dan yang lebih baru. Di Windows 2000, itu diekspor dari Ole32.dll. Ini juga dapat diekspor dari iprop.dll di Windows 2000, tetapi panggilan akan 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