ITfCoNtextOwnerServices::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,則會在呼叫此方法時從 pStream 讀取屬性資料。 如果指定 pLoader 而不是 pStream,則會以非同步方式從 pLoader 讀取屬性資料。 如果屬性資料很大,使用 pStream 可能會導致長時間延遲。

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

需求

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

另請參閱

ITfCoNtextOwnerServices 介面ITfCoNtextOwnerServices::SerializeITfProperty 介面ITfPersistentPropertyLoaderACP 介面TF_PERSISTENT_PROPERTY_HEADER_ACP 結構