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

SafeArrayGetUBound

Возвращает верхнюю границу для заданного измерения безопасного массива.

HRESULT SafeArrayGetUBound
( 
SAFEARRAY FAR *psa, 
unsigned int nDim, 
long FAR* plUbound
);

Параметры:
psa
Указатель на дескриптор массива, созданный с помощью SafeArrayCreate.
nDim
Измерение массива, для которого требуется получить верхнюю границу.
plUbound
Указатель, по которому возвращается значение верхней границы.

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

Код возврата	Значение
S_OK	Успех.
DISP_E_BADINDEX	Задан неверный индекс.
E_INVALIDARG	Один из аргументов неверен.

Пример:

HRESULT CEnumPoint::Create(SAFEARRAY FAR* psa, CEnumPoint FAR* FAR* ppenum)
{
long IBound;
HRESULT hresult;
CEnumPoint FAR* penum;
// Проверить, имеет ли безопасный массив надлежащую форму

hresult = SafeArrayGetUBound(psa, 1, &lBound); 

if(FAILED(hresult))
goto LErrorO;

// Код опущен для экономии места

LErrorO:;
penum->Release();

 return hresult;