Windows apps
Collapse the table of content
Expand the table of content
Information
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.

PropVariantCopy function

The PropVariantCopy function copies the contents of one PROPVARIANT structure to another.

Syntax


WINOLEAPI PropVariantCopy(
  _Inout_       PROPVARIANT *pvarDest,
  _In_    const PROPVARIANT *pvarSrc
);

Parameters

pvarDest [in, out]

Pointer to an uninitialized PROPVARIANT structure that receives the copy.

pvarSrc [in]

Pointer to the PROPVARIANT structure to be copied.

Return value

S_OK

The copy was successfully completed.

STG_E_INVALID_PARAMETER

The variant has an unknown type.

Remarks

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.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps | Windows Store apps]

Minimum supported server

Windows 2000 Server [desktop apps | Windows Store apps]

Minimum supported phone

Windows Phone 8

Header

Propidl.h

Library

Ole32.lib

DLL

Ole32.dll

See also

PROPVARIANT
PropVariantClear

 

 

Community Additions

Show:
© 2017 Microsoft