Função PropVariantCopy (combaseapi.h)

A função PropVariantCopy copia o conteúdo de uma estrutura PROPVARIANT para outra.

Sintaxe

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

Parâmetros

[in, out] pvarDest

Ponteiro para uma estrutura PROPVARIANT não inicializada que recebe a cópia.

[in] pvarSrc

Ponteiro para a estrutura PROPVARIANT a ser copiada.

Retornar valor

Essa função retorna HRESULT.

Comentários

Copia uma estrutura PROPVARIANT por valor para que os parâmetros pvarSrc e novos pvarDest originais possam ser liberados independentemente com chamadas para PropVariantClear. PropVariantCopy não libera o destino como a função VariantCopy faz. Para tipos PROPVARIANT não simplificados, como VT_STREAM, VT_STORAGE e assim por diante, que exigem um subobjeto, a cópia é feita por referência. O ponteiro é copiado e IUnknown::AddRef é chamado nele. É ilegal passar NULL para pvarDest ou pvarSrc.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte	Windows 2000 Server [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	combaseapi.h
Biblioteca	Ole32.lib
DLL	Ole32.dll

Confira também

PROPVARIANT, PropVariantClear