Export (0) Print
Expand All
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.


Windows Mobile 6.5
A version of this page is also available for

This function copies the contents of one PROPVARIANT structure to another.

WINOLEAPI PropVariantCopy(
  PROPVARIANT*       pvarDest,
  const PROPVARIANT* pvarSrc


[in, out] Pointer to an uninitialized PROPVARIANT structure that receives the copy.


[in] Pointer to the PROPVARIANT structure to be copied.

The following table shows the return values for this function.

Value Description


The copy was successfully completed.


The variant has an unknown type.

Copies a PROPVARIANT structure by value so the original pvarSrc and new pvarDest parameters may be freed independently with calls to PropVariantClear. PropVariantCopy does not free the destination as the VariantCopy function does. For nonsimple PROPVARIANT types such as VT_STREAM, VT_STORAGE, and so forth, which require a subobject, the copy is made by reference. The pointer is copied and IUnknown::AddRef is called on it. It is illegal to pass NULL for either pvarDest or pvarSrc.

Windows Embedded CEWindows CE 2.0 and later
Windows MobileWindows Mobile Version 5.0 and later

Community Additions

© 2015 Microsoft