Шаг 97 - 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) используют одни и те же правила.


Предыдущий Шаг | Следующий Шаг | Оглавление
Автор Каев Артем - 16.03.2003