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
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) | Windows 2000 Professional [Desktop-Apps | UWP-Apps] |
Unterstützte Mindestversion (Server) | Windows 2000 Server [Desktop-Apps | UWP-Apps] |
Zielplattform | Windows |
Kopfzeile | combaseapi.h |
Bibliothek | Ole32.lib |
DLL | Ole32.dll |