PropVariantToVariant 函数 (propvarutil.h)

  • 项目

将 PROPVARIANT 结构的内容转换为 VARIANT 结构。

语法

PSSTDAPI PropVariantToVariant(
  [in]  const PROPVARIANT *pPropVar,
  [out] VARIANT           *pVar
);

参数

[in] pPropVar

类型： const PROPVARIANT*

指向源 PROPVARIANT 结构的指针。

[out] pVar

类型： VARIANT*

指向 VARIANT 结构的指针。 当此函数返回时， VARIANT 包含转换后的信息。

返回值

类型： HRESULT

如果此函数成功，则返回 S_OK。 否则，将返回 HRESULT 错误代码。

注解

通常， 存储在 PROPVARIANT 中的数据将复制到 VARIANT ，而无需更改数据类型。 但是，在以下情况下，没有对数据类型的直接 VARIANT 支持，它们将按如下所示进行转换。

原始 PROPVARIANT 类型 存储为 VARIANT 类型
VT_STREAM VT_BLOB VT_UNKNOWN。 punkVal 成员将包含指向包含源数据的 IStream 的指针。
VT_LPSTR、VT_LPWSTR、VT_CLSID VT_BSTR
VT_FILETIME VT_DATE
VT_VECTOR|x VT_ARRAY|y
 

不能使用此函数转换以下类型。

  • VT_STORAGE
  • VT_BLOB_OBJECT
  • VT_STREAMED_OBJECT
  • VT_STORED_OBJECT
  • VT_CF
  • VT_VECTOR |VT_CF

要求

要求 值
最低受支持的客户端 Windows Vista、Windows XP 和 SP2 [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 SP1 [仅限桌面应用]
目标平台 Windows
标头 propvarutil.h
Library Propsys.lib
DLL Propsys.dll (版本 6.0 或更高版本)
可再发行组件 Windows 桌面搜索 (WDS) 3.0