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 。 为 pvarDest 或 pvarSrc 传递 NULL 是非法的。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 2000 专业版 [桌面应用 |UWP 应用] |
最低受支持的服务器 | Windows 2000 Server [桌面应用 |UWP 应用] |
目标平台 | Windows |
标头 | combaseapi.h |
Library | Ole32.lib |
DLL | Ole32.dll |