iTfContextOwnerServices：：Serialize 方法 (msctf.h)

ITfContextOwnerServices：：Serialize 方法會從文字範圍取得屬性，並將屬性數據寫入數據流物件。 這可讓應用程式在將數據寫入檔案時儲存屬性數據。

語法

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

參數

[in] pProp

識別要串行化之屬性的 ITfProperty 介面指標。

[in] pRange

ITfRange 介面的指標，識別從中取得屬性的範圍。

[out] pHdr

接收 屬性之標頭數據的 TF_PERSISTENT_PROPERTY_HEADER_ACP 結構的指標。

[in] pStream

TSF 管理員將寫入屬性數據的 IStream 物件指標。

傳回值

這個方法可以傳回下列其中一個值。

備註

放置於 pHdr 中的屬性標頭數據對所有屬性都是通用的，而且必須與寫入 pStream 的數據一起保留。 這個相同的數據組必須傳遞至 ITfContextOwnerServices：：Unserialize ，才能還原屬性數據。

應用程式可以執行下列步驟，以儲存整份檔的所有屬性。

• 使用 ITfContext：：EnumProperties 列舉所有屬性。
• 在每個屬性內，使用 ITfReadOnlyProperty：：EnumRanges 列舉範圍。
• 將目前的 屬性和範圍傳遞至這個方法。
• 將數據寫入 pHdr 中的檔案。
• 將新增至 pStream 的數據寫入檔案。

規格需求

另請參閱

ITfContextOwnerServices

ITfProperty

ITfRange

TF_PERSISTENT_PROPERTY_HEADER_ACP