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：：Serialize、 ITfContext：：EnumProperties、 ITfProperty 接口、 ITfRange 接口、 ITfReadOnlyProperty：：EnumRanges、 TF_PERSISTENT_PROPERTY_HEADER_ACP 结构