ITfContextOwnerServices：：Unserialize 方法 (msctf.h)

  • 项目

将以前序列化的属性数据应用于属性对象。

语法

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

parameters

[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：：Serialize、ITfProperty 接口、ITfPersistentPropertyLoaderACP 接口、TF_PERSISTENT_PROPERTY_HEADER_ACP 结构