COleSafeArray Methods

Construction Methods

Method Description
COleSafeArray Constructs a COleSafeArray object.

Operations Methods

Method Description
Attach Gives control of the existing VARIANT array to the COleSafeArray object.
Clear Clears the safe array.
Detach Detaches the VARIANT array from the COleSafeArray object (so that the data will not be freed).

Win32 API Wrapper Methods

Method Description
AccessData Retrieves a pointer to the array data.
AllocData Allocates memory for the array.
AllocDescriptor Allocates memory for the safe array descriptor.
Copy Creates a copy of an existing array.
Create Creates a safe array.
Destroy Destroys an existing array.
DestroyData Destroys data in a safe array.
DestroyDescriptor Destroys a descriptor of a safe array.
GetDim Returns the number of dimensions in the array.
GetElement Retrieves a single element of the safe array.
GetElemSize Returns the size, in bytes, of one element in a safe array.
GetLBound Returns the lower bound for any dimension of a safe array.
GetUBound Returns the upper bound for any dimension of a safe array.
Lock Increments the lock count of an array and places a pointer to the array data in the array descriptor.
PtrOfIndex Returns a pointer to the element specified by the index values.
PutElement Assigns a single element into the array.
Redim Changes the least significant (rightmost) bound of a safe array.
UnaccessData Decrements the lock count of an array and invalidates the pointer retrieved by AccessData.
Unlock Decrements the lock count of an array so it can be freed or resized.

One-Dimensional Array Operations Methods

Method Description
CreateOneDim Creates a one-dimensional COleSafeArray object.
GetOneDimSize Returns the number of elements in the one-dimensional COleSafeArray object.
ResizeOneDim Changes the number of elements in a one-dimensional COleSafeArray object.