VariantCopy
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 |