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。
傳回值
這個方法可以傳回下列其中一個值。
值 | 描述 |
---|---|
|
此方法成功。 |
|
屬性數據會以異步方式取得。 |
|
無法取得同步只讀鎖定。 |
|
發生未指定的錯誤。 |
備註
如果指定 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::Serialize、 ITfContext::EnumProperties、 ITfProperty 介面、 ITfRange 介面、 ITfReadOnlyProperty::EnumRanges、 TF_PERSISTENT_PROPERTY_HEADER_ACP 結構