ITfContextOwnerServices::Metode serialize (msctf.h)

Artikel
03/08/2023

Metode ITfContextOwnerServices::Serialize mendapatkan properti dari berbagai teks dan menulis data properti ke dalam objek stream. Ini memungkinkan aplikasi untuk menyimpan data properti, misalnya, saat menulis data ke file.

Sintaks

HRESULT Serialize(
  [in]  ITfProperty                       *pProp,
  [in]  ITfRange                          *pRange,
  [out] TF_PERSISTENT_PROPERTY_HEADER_ACP *pHdr,
  [in]  IStream                           *pStream
);

Parameter

[in] pProp

Penunjuk ke antarmuka ITfProperty yang mengidentifikasi properti untuk diserialisasikan.

[in] pRange

Penunjuk ke antarmuka ITfRange yang mengidentifikasi rentang tempat properti diperoleh.

[out] pHdr

Penunjuk ke struktur TF_PERSISTENT_PROPERTY_HEADER_ACP yang menerima data header untuk properti .

[in] pStream

Penunjuk ke objek IStream tempat manajer TSF akan menulis data properti.

Nilai kembali

Metode ini dapat mengembalikan salah satu nilai ini.

Nilai	Deskripsi
S_OK	Metode berhasil.
S_FALSE	Properti tidak dapat diserialisasikan.
E_FAIL	Terjadi kesalahan yang tidak ditentukan.

Keterangan

Data header properti yang ditempatkan dalam pHdr umum untuk semua properti dan harus dipertahankan dengan data yang ditulis ke dalam pStream. Pasangan data yang sama ini harus diteruskan ke ITfContextOwnerServices::Unserialize untuk memulihkan data properti.

Aplikasi dapat menyimpan semua properti untuk seluruh dokumen dengan melakukan langkah-langkah berikut.

Menghitung semua properti menggunakan ITfContext::EnumProperties.
Dalam setiap properti, hitung rentang menggunakan ITfReadOnlyProperty::EnumRanges.
Teruskan properti dan rentang saat ini ke metode ini.
Tulis data yang ditempatkan dalam pHdr ke file.
Tulis data yang ditambahkan ke pStream ke file.

Saat memanggil metode ini, aplikasi harus dapat memberikan kunci baca-saja yang sinkron.

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	msctf.h
DLL	Msctf.dll
Redistribusi	TSF 1.0 di Windows 2000 Professional

Lihat juga

ITfContextOwnerServices

ITfProperty

ITfRange

TF_PERSISTENT_PROPERTY_HEADER_ACP

Bagikan melalui