SafeArrayCopy

9/8/2008

Essa função cria um copiar de um SafeArray existente.

Syntax

HRESULT SafeArrayCopy(
  SAFEARRAY FAR* psa, 
  SAFEARRAY FAR* FAR* ppsaOut 
); 

Parameters

• psa
  [no] Ponteiro para uma descritor de matriz criado por SafeArrayCreate.

• ppsaOut
  [out] Ponteiro para uma localidade no qual retornar o novo descritor de matriz.

Return Value

Retorna os valores HRESULT mostrados a seguinte tabela.

Valor	Descrição
S_OK	O sucesso.
E_INVALIDARG	O psa parâmetro não era um válido SafeArray descritor.
E_OUTOFMEMORY	Memória insuficiente para criar a copiar.

Remarks

SafeArrayCopy Chamadas as funções de manipulação seqüência de caracteres ou variante se a matriz para copiar contém um desses tipos dados.

Se a matriz que está sendo copiado contém referências objeto, a contagem de referência para os objetos é incrementadas.

Passagem inválido (e, em algumas circunstâncias NULL) ponteiros para essa função faz com que uma terminação inesperada do aplicativo.

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

See Also

Reference

Automation Functions
SysAllocStringLen
VariantCopy
VariantCopyInd
SafeArrayCreate