Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

CComSafeArray::Create

 

Creates a CComSafeArray.


      HRESULT Create(
   const SAFEARRAYBOUND * pBound,
   UINT uDims = 1 
);
HRESULT Create(
   ULONG ulCount = 0,
   LONG lLBound = 0 
);

pBound

A pointer to a SAFEARRAYBOUND object.

uDims

The number of dimensions in the array.

ulCount

The number of elements in the array.

lLBound

The lower bound value; that is, the index of the first element in the array.

Returns S_OK on success, or an error HRESULT on failure.

A CComSafeArray object can be created from an existing SAFEARRAYBOUND structure and the number of dimensions, or by specifying the number of elements in the array and the lower bound. If the array is to be accessed from Visual C++, the lower bound should be 0. Other languages may allow other values for the lower bound (for example, Visual Basic supports arrays with elements with a range such as -10 to 10).

Requirements

Header: atlsafe.h

Show: