PropVariantCopy

9/8/2008

Esta função copia o conteúdo de uma estrutura PROPVARIANT para outro.

Syntax

WINOLEAPI PropVariantCopy(
  PROPVARIANT*       pvarDest,
  const PROPVARIANT* pvarSrc
);

Parameters

• pvarDest
  [in, Out] Ponteiro para um não inicializado PROPVARIANT estrutura que recebe a copiar.

• pvarSrc
  [no] Ponteiro para o PROPVARIANT estrutura a serem copiados.

Valores Return

A seguinte tabela mostra os valores de retorno para esta função.

Valor	Descrição
S_OK	A copiar foi concluída com êxito.
STG_E_INVALID_PARAMETER	A variante tem um tipo desconhecido.

Remarks

Copia um PROPVARIANT estrutura por valor assim o original pvarSrc Novas e pvarDest Os parâmetros podem ser liberados independentemente com chamadas para PropVariantClear. PropVariantCopy Não livre de destino como a VariantCopy função faz. Para não simples PROPVARIANT tipos, como VT_STREAM, VT_STORAGE e assim por diante, que requerem um subobjeto, a copiar é feita por referência. O ponteiro é copiado e IUnknown::AddRef é chamado nele. É ilegal para transmitir NULL para um pvarDest Ou pvarSrc.

Requirements

Header	oaidl.h
Library	oleaut32.lib
Windows Embedded CE	Windows CE 2.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Reference

Automation Functions
PROPVARIANT
PropVariantClear
VariantCopy
IUnknown::AddRef