Копирует исходный массив в другой (целевой) массив, предварительно освободив содержимое последнего. Функция аналогична 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) используют одни и те же правила.