PropVariantCopy 函数 (combaseapi.h)

PropVariantCopy 函数将一个 PROPVARIANT 结构的内容复制到另一个结构。

语法

HRESULT PropVariantCopy(
  [in, out] PROPVARIANT       *pvarDest,
  [in]      const PROPVARIANT *pvarSrc
);

参数

[in, out] pvarDest

指向接收副本的未初始化 PROPVARIANT 结构的指针。

[in] pvarSrc

指向要复制的 PROPVARIANT 结构的指针。

返回值

此函数返回 HRESULT。

注解

按值复制 PROPVARIANT 结构,以便通过调用 PropVariantClear 独立释放原始 pvarSrc 和新的 pvarDest 参数。 PropVariantCopy 不会像 VariantCopy 函数那样释放目标。 对于需要子对象的非简单 PROPVARIANT 类型(如 VT_STREAM、VT_STORAGE 等),通过引用进行复制。 复制指针,并在其中调用 IUnknown::AddRef 。 为 pvarDestpvarSrc 传递 NULL 是非法的。

要求

要求
最低受支持的客户端 Windows 2000 专业版 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows 2000 Server [桌面应用 |UWP 应用]
目标平台 Windows
标头 combaseapi.h
Library Ole32.lib
DLL Ole32.dll

另请参阅

PROPVARIANTPropVariantClear