ITextStoreACPServices：：Serialize 方法 (msctf.h)

從文字範圍取得屬性，並將屬性數據寫入數據流物件。

語法

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 物件指標。

傳回值

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

值	描述
S_OK	此方法成功。
S_FALSE	屬性無法串行化。
E_FAIL	發生未指定的錯誤。

備註

放在 pHdr 中的屬性標頭數據是所有屬性的泛型，而且必須保留寫入 pStream 的數據。 這個相同的數據組必須傳遞至 ITextStoreACPServices：：Unserialize 以還原屬性數據。

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

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

呼叫此方法時，應用程式必須能夠授與同步唯讀鎖定。

規格需求

需求	值
最低支援的用戶端	Windows 2000 專業版 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器	Windows 2000 Server [傳統型應用程式 |UWP 應用程式]
目標平台	Windows
標頭	msctf.h
Dll	Msctf.dll
可轉散發套件	Windows 2000 專業版上的 TSF 1.0

另請參閱

ITextStoreACPServices 介面、 ITextStoreACPServices：：Unserialize、 ITfContext：：EnumProperties、 ITfProperty 介面、 ITfRange 介面、 ITfReadOnlyProperty：：EnumRanges、 TF_PERSISTENT_PROPERTY_HEADER_ACP 結構