ITextStoreACPServices::Unserialize 方法 (msctf.h)

採用先前串行化的屬性數據,並將它套用至屬性物件。

語法

HRESULT Unserialize(
  [in] ITfProperty                             *pProp,
  [in] const TF_PERSISTENT_PROPERTY_HEADER_ACP *pHdr,
  [in] IStream                                 *pStream,
  [in] ITfPersistentPropertyLoaderACP          *pLoader
);

參數

[in] pProp

接收屬性數據的 ITfProperty 物件的指標。

[in] pHdr

包含屬性標頭數據的 TF_PERSISTENT_PROPERTY_HEADER_ACP 結構的指標。

[in] pStream

包含屬性數據的 IStream 物件的指標。 如果 pLoader 不是 NULL,這個參數可以是 NULL。 如果 pLoader 不是 NULL,則會忽略此參數。

[in] pLoader

TSF 管理員將用來取得屬性數據的 ITfPersistentPropertyLoaderACP 物件的指標。 如果 pStream 不是 NULL,此參數可以是 NULL

傳回值

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

描述
S_OK
此方法成功。
TF_S_ASYNC
屬性數據會以異步方式取得。
TF_E_SYNCHRONOUS
無法取得同步只讀鎖定。
E_FAIL
發生未指定的錯誤。

備註

如果指定 pStream 而不是 pLoader,則會在呼叫 Unserialize 期間從 pStream 讀取屬性數據。 如果指定 pLoader 而不是 pStream,則會以異步方式從 pLoader 讀取屬性數據。 如果屬性數據很大,使用 pStream 可能會導致長時間延遲。

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

規格需求

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

另請參閱

ITextStoreACPServices 介面ITextStoreACPServices::SerializeITfContext::EnumPropertiesITfProperty 介面ITfRange 介面ITfReadOnlyProperty::EnumRangesTF_PERSISTENT_PROPERTY_HEADER_ACP 結構