Справочник по технологии COM
Страница 94. SafeArrayCopy


 

SafeArrayCopy

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

HRESULT SafeArrayCopy
(
SAFEARRAY FAR*psa,
SAFEARRAY FAR* FAR*ppsaOut
);

Параметры:
psa
Указатель на дескриптор массива, созданный SafeArrayCreate.
ppsaOut
Указатель, по которому возвращается дескриптор нового массива.

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

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

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

 
Следующая статья »