VariantCopy
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/8/2008
Essa função libera a variante destino e o torna um copiar da variante de origem.
Syntax
HRESULT VariantCopy(
VARIANTARG FAR* pvargDest,
VARIANTARG FAR* pvargSrc
);
Parameters
- pvargDest
[out] Ponteiro para o VARIANTARG Para receber a copiar.
- pvargSrc
[no] Ponteiro para o VARIANTARG a serem copiados.
Return Value
Retorna os valores HRESULT mostrados a seguinte tabela.
| Valor | Descrição |
|---|---|
S_OK |
O sucesso. |
DISP_E_ARRAYISLOCKED |
A variante contém uma matriz que está bloqueada. |
DISP_E_BADVARTYPE |
A origem e destino possuem um inválido variante tipo (geralmente não inicializado). |
E_OUTOFMEMORY |
Não foi possível alocar memória para a copiar. |
E_INVALIDARG |
Um argumento é inválido. |
Remarks
Passagem inválido (e, em algumas circunstâncias NULL) ponteiros para essa função faz com que uma terminação inesperada do aplicativo.
Primeiro, livre qualquer memória que é de propriedade pvargDest, como VariantClear. (pvargDest deve apontar para um válido inicializado variante e não simplesmente para um não inicializado localidade memória.) Em seguida, pvargDest Recebe um copiar exata do conteúdo do pvargSrc.
Se pvargSrc é um VT_BSTR, um copiar do seqüência de caracteres é feita.
Se pvargSrc é um VT_ARRAY, a matriz inteira é copiada.
Se pvargSrc é um VT_DISPATCH ou VT_UNKNOWN, AddRef é chamado para incremento contagem de referência do o objeto.
Requirements
| Header | oleauto.h |
| Library | oleaut32.lib |
| Windows Embedded CE | Windows CE 2.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |