PropVariantCopy-Funktion (combaseapi.h)

Die PropVariantCopy-Funktion kopiert den Inhalt einer PROPVARIANT-Struktur in eine andere.

Syntax

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

Parameter

[in, out] pvarDest

Zeiger auf eine nicht initialisierte PROPVARIANT-Struktur , die die Kopie empfängt.

[in] pvarSrc

Zeiger auf die zu kopierende PROPVARIANT-Struktur .

Rückgabewert

Diese Funktion gibt HRESULT zurück.

Hinweise

Kopiert eine PROPVARIANT-Struktur nach Wert, sodass die ursprünglichen pvarSrc - und neuen pvarDest-Parameter unabhängig durch Aufrufe von PropVariantClear freigegeben werden können. PropVariantCopy gibt das Ziel nicht frei, wie die VariantCopy-Funktion dies tut. Für nicht einfache PROPVARIANT-Typen wie VT_STREAM, VT_STORAGE usw., die ein Unterobjekt erfordern, erfolgt die Kopie durch Verweis. Der Zeiger wird kopiert, und IUnknown::AddRef wird darauf aufgerufen. Es ist unzulässig, NULL entweder für pvarDest oder pvarSrc zu übergeben.

Anforderungen

Weitere Informationen

PROPVARIANT, PropVariantClear