Справочник по технологии COM
Страница 95. SafeArrayCopyData
Страница 95 из 111
 

SafeArrayCopyData

Копирует исходный массив в другой (целевой) массив, предварительно освободив содержимое последнего. Функция аналогична SafeArrayCopy, за исключением того, что принимающий массив должен быть создан заранее. Функция не создает целевой массив и не изменяет его размеров. 

HRESULT SafeArrayCopyData
( 
SAFEARRAY FAR* psaSource, 
SAFEARRAY FAR* FAR* psa Target
);

Параметры:
psaSource
Безопасный массив, данные из которого следует скопировать.
psaTarget
После возврата из функции массив, на который ссылается данный параметр, содержит копию данных из psaSource.

Коды возврата:
Из возвращенного HRESULT получают один из следующих кодов возврата:

Код возврата Значение
S_OK Успех.
E_INVALIDARG Параметр psa не является правильным дескриптором безопасного массива.
E_OUTOFMEMORY Для создания копии не хватает памяти.

Комментарии:
В тех случаях, когда размеры исходного и целевого массивов не совпадают, Автоматизация и Visual Basic for Applications (VBA) используют одни и те же правила.
 
Следующая статья »