COleSafeArray::GetUBound

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

セーフ配列の任意の次元について上限を返します。

void GetUBound(
   DWORD dwDim,
   long* pUBound 
);

パラメータ

dwDim
上限を取得する配列の次元。
pUBound
上限を返すバッファへのポインタ。

解説

エラーの場合、関数は COleException クラスをスローします。

使用例

COleSafeArray saMatrix;
DWORD numElements[] = {10, 5};

// creates a 2 dimensional safearray of type VT_I2 
// with size 10x5 elements, with all indices starting at 0(default)
saMatrix.Create(VT_I2, 2, numElements);

long lUBound;
ASSERT(saMatrix.GetDim() == 2);

//get upper bound for 1st dimension
saMatrix.GetUBound(1, &lUBound);

ASSERT(lUBound == 9);

//get upper bound for 2nd dimension
saMatrix.GetUBound(2, &lUBound);

ASSERT(lUBound == 4);

COleSafeArray saVector;
SAFEARRAYBOUND rgsabounds[] = { {5, 1} };

// creates a 1 dimensional safearray of type VT_I1 
// with size 5 elements, with the index starting at 1
saVector.Create(VT_I1, 1, rgsabounds);

//get upper bound for 1st dimension
saVector.GetUBound(1, &lUBound);

ASSERT(lUBound == 5);