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 结构