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 的數據寫入檔案。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 2000 專業版 [傳統型應用程式 |UWP 應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [傳統型應用程式 |UWP 應用程式] |
| 目標平台 | Windows |
| 標頭 | msctf.h |
| Dll | Msctf.dll |
| 可轉散發套件 | Windows 2000 專業版上的 TSF 1.0 |