Metode IPersistSerializedPropStorage::GetPropertyStorage (propsys.h)

Artikel
03/04/2024

Mendapatkan data penyimpanan properti berseri dari instans penyimpanan properti.

Sintaks

HRESULT GetPropertyStorage(
  [out] SERIALIZEDPROPSTORAGE **ppsps,
  [out] DWORD                 *pcb
);

Parameter

[out] ppsps

Jenis: SERIALIZEDPROPSTORAGE**

Ketika metode ini kembali, berisi alamat penunjuk ke data penyimpanan properti berseri.

[out] pcb

Jenis: DWORD*

Ketika metode ini kembali, berisi jumlah byte yang terkandung dalam data penyimpanan properti serial yang ditunjukkan oleh pps.

Mengembalikan nilai

Jenis: HRESULT

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

Keterangan

Jenis SERIALIZEDPROPSTORAGE didefinisikan dalam Propsys.h sebagai jenis yang tidak lengkap. Ini harus diperlakukan sebagai array nilai BYTE ; format data yang dikembalikan tidak ditentukan. Konten struktur SERIALIZEDPROPSTORAGE cocok untuk bertahan pada disk atau penyimpanan lain dan dapat digunakan untuk menginisialisasi penyimpanan properti lain melalui IPersistSerializedPropStorage::SetPropertyStorage.

Catatan Ini adalah tanggung jawab aplikasi yang memanggil IPersistSerializedPropStorage::GetPropertyStorage untuk kemudian memanggil CoTaskMemFree untuk merilis memori yang dirujuk oleh pps ketika tidak lagi diperlukan.

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