Поделиться через


Функция SafeArrayCopy (oleauto.h)

Создает копию существующего безопасного массива.

Синтаксис

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

Параметры

[in] psa

Дескриптор безопасного массива, созданный safeArrayCreate.

[out] ppsaOut

Дескриптор безопасного массива.

Возвращаемое значение

Эта функция может возвращать одно из этих значений.

Код возврата Описание
S_OK
Успешно.
E_INVALIDARG
Недопустимый аргумент psa .
E_OUTOFMEMORY
Недостаточно памяти для завершения операции.

Комментарии

SafeArrayCopy вызывает строковые или вариантные функции манипуляции, если копируемая матрица содержит любой из этих типов данных. Если копируемый массив содержит ссылки на объекты, количество ссылок для объектов увеличивается.

Требования

Требование Значение
Целевая платформа Windows
Header oleauto.h
Библиотека OleAut32.lib
DLL OleAut32.dll

См. также раздел

SysAllocStringLen

VariantCopy

VariantCopyInd