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


SafeArrayRedim

Изменяет границы самого правого (наименее значащего) измерения безопасного массива.

HRESULT SafeArrayRedim
(
SAFEARRAY FAR* psa,
SAFEARRAYBOUND FAR* psaboundNew
);

Параметры:
psa
Указатель на дескриптор массива.
psaboundNew
Указывает на структуру, задающую новые границы безопасного массива. Вы можете изменить границы только самого правого измерения массива.

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

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

Комментарии:
Если Вы сужаете границы массива, то SafeArrayRedim освобождает элементы массива, выходящие за его новую границу. При расширении границ массива функция размещает и инициализирует новые элементы. Данные элементов, которые присутствуют как в старом, так и в новом массиве, сохраняются.

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