Создает копию безопасного массива.
HRESULT SafeArrayCopy ( SAFEARRAY FAR*psa, SAFEARRAY FAR* FAR*ppsaOut );
Параметры:
psa
Указатель на дескриптор массива, созданный SafeArrayCreate.
ppsaOut
Указатель, по которому возвращается дескриптор нового массива.
Коды возврата:
Из возвращенного HRESULT получают один из следующих кодов возврата:
Код возврата | Значение |
---|---|
S_OK | Успех. |
E_INVALIDARG | Параметр psa не является правильным дескриптором безопасного массива. |
E_OUTOFMEMORY | Для создания копии не хватает памяти. |
Комментарии:
SafeArrayCopy вызывает функции для работы со строками и вариантами, если элементы копируемого массива имеют соответствующие типы. Если копируемый массив содержит ссылки на объекты, то счетчики ссылок объектов увеличиваются.