Metode IPersistSerializedPropStorage::SetFlags (propsys.h)

Artikel
08/25/2023

Alihkan objek penyimpanan properti antara status baca-saja dan baca/tulis.

Sintaks

HRESULT SetFlags(
  [in] PERSIST_SPROPSTORE_FLAGS flags
);

Parameter

[in] flags

Jenis: PERSIST_SPROPSTORE_FLAGS

Parameter bendera mengambil salah satu nilai berikut untuk mengatur opsi perilaku penyimpanan properti:

FPSPS_DEFAULT (0x00000000)

Windows 7 dan yang lebih baru. Objek penyimpanan properti adalah baca/tulis.

FPSPS_READONLY (0x00000001)

Objek penyimpanan properti bersifat baca-saja.

FPSPS_TREAT_NEW_VALUES_AS_DIRTY (0x00000002)

Diperkenalkan dalam Windows 8. Nilai properti baru yang ditambahkan ke penyimpanan properti melalui metode IPropertyStore::SetValue akan menyebabkan metode IPersistStream::IsDirty mengembalikan S_OK. Jika bendera ini tidak diatur, penambahan nilai properti baru ke penyimpanan properti tidak memengaruhi nilai yang dikembalikan oleh IPersistStream::IsDirty.

Mengembalikan nilai

Jenis: HRESULT

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

Keterangan

Baca/tulis adalah pengaturan default. IPersistSerializedPropStorage::SetFlags dapat dipanggil kapan saja untuk mengaktifkan status baca-saja dan baca/tulis penyimpanan properti.

Dalam versi Windows sebelum Windows 7, penelepon dapat menetapkan nilai nol harfiah langsung ke parameter bendera untuk mengatur status baca/tulis. Pada Windows 7, nilai bendera FPSPS_DEFAULT harus digunakan sebagai gantinya.

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