Funzione PropVariantCopy (combaseapi.h)

La funzione PropVariantCopy copia il contenuto di una struttura PROPVARIANT in un'altra.

Sintassi

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

Parametri

[in, out] pvarDest

Puntatore a una struttura PROPVARIANT non inizializzata che riceve la copia.

[in] pvarSrc

Puntatore alla struttura PROPVARIANT da copiare.

Valore restituito

Questa funzione restituisce HRESULT.

Commenti

Copia una struttura PROPVARIANT in base al valore in modo che i parametri pvarSrc originali e nuovi parametri pvarDest vengano liberati in modo indipendente con chiamate a PropVariantClear. PropVariantCopy non libera la destinazione perché la funzione VariantCopy esegue. Per i tipi PROPVARIANT non simili, ad esempio VT_STREAM, VT_STORAGE e così via, che richiedono un oggetto secondario, la copia viene effettuata tramite riferimento. Il puntatore viene copiato e viene chiamato IUnknown::AddRef . È illegale passare NULL per pvarDest o pvarSrc.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [app desktop | App UWP]
Server minimo supportato	Windows 2000 Server [app desktop | App UWP]
Piattaforma di destinazione	Windows
Intestazione	combaseapi.h
Libreria	Ole32.lib
DLL	Ole32.dll

Vedi anche

PROPVARIANT, PropVariantClear