Compartilhar via

Função SafeArrayCopy (oleauto.h)

  • Artigo

Cria uma cópia de uma matriz segura existente.

Sintaxe

HRESULT SafeArrayCopy(
  [in]  SAFEARRAY *psa,
  [out] SAFEARRAY **ppsaOut
);

Parâmetros

[in] psa

Um descritor de matriz segura criado por SafeArrayCreate.

[out] ppsaOut

O descritor de matriz segura.

Retornar valor

Essa função pode retornar um desses valores.

Código de retorno Descrição
S_OK
 Êxito.
E_INVALIDARG
 O argumento psa não era válido.
E_OUTOFMEMORY
 Memória insuficiente para concluir a operação.

Comentários

SafeArrayCopy chamará as funções de manipulação de cadeia de caracteres ou variantes se a matriz a ser copiada contiver um desses tipos de dados. Se a matriz que está sendo copiada contiver referências de objeto, as contagens de referência para os objetos serão incrementadas.

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho oleauto.h
Biblioteca OleAut32.lib
DLL OleAut32.dll

Confira também

Sysallocstringlen

VariantCopy

VariantCopyInd