Función SafeArrayCopy (oleauto.h)

  • Artículo

Crea una copia de una matriz segura existente.

Sintaxis

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

Parámetros

[in] psa

Descriptor de matriz seguro creado por SafeArrayCreate.

[out] ppsaOut

Descriptor de matriz seguro.

Valor devuelto

Esta función puede devolver uno de estos valores.

Código devuelto Descripción
S_OK
 Correcto.
E_INVALIDARG
 El argumento psa no era válido.
E_OUTOFMEMORY
 Memoria insuficiente para completar la operación.

Comentarios

SafeArrayCopy llama a las funciones de manipulación de cadena o variante si la matriz que se va a copiar contiene cualquiera de estos tipos de datos. Si la matriz que se copia contiene referencias de objeto, se incrementan los recuentos de referencias de los objetos.

Requisitos

Requisito Value
Plataforma de destino Windows
Encabezado oleauto.h
Library OleAut32.lib
Archivo DLL OleAut32.dll

Consulte también

SysAllocStringLen

VariantCopy

VariantCopyInd