Fonction PropVariantCopy (combaseapi.h)

La fonction PropVariantCopy copie le contenu d’une structure PROPVARIANT vers une autre.

Syntaxe

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

Paramètres

[in, out] pvarDest

Pointeur vers une structure PROPVARIANT non initialisée qui reçoit la copie.

[in] pvarSrc

Pointeur vers la structure PROPVARIANT à copier.

Valeur retournée

Cette fonction retourne HRESULT.

Remarques

Copie une structure PROPVARIANT par valeur afin que les paramètres pvarSrc d’origine et pvarDest puissent être libérés indépendamment avec des appels à PropVariantClear. PropVariantCopy ne libère pas la destination comme le fait la fonction VariantCopy . Pour les types PROPVARIANT non simples tels que VT_STREAM, VT_STORAGE, etc., qui nécessitent un sous-objet, la copie est effectuée par référence. Le pointeur est copié et IUnknown ::AddRef y est appelé. Il est interdit de passer la valeur NULL pour pvarDest ou pvarSrc.

Configuration requise

Voir aussi

PROPVARIANT, PropVariantClear