Function Reference


_SafeArrayCreateEx

Creates a SafeArray with default bounds if none are specified.

_SafeArrayCreateEx([$vType = $VT_VARIANT [, $cDims = 1 [, $pBounds = 0 [, $iDefaultElements = 10]]]])

Parameters

$vType (Optional) VARIANT type for elements (default: $VT_VARIANT).
$cDims (Optional) Number of dimensions (1 to 5, default: 1).
$pBounds (Optional) Pointer to SAFEARRAYBOUND structure (default: 0, creates default bounds).
$iDefaultElements (Optional) Number of elements for default bounds (default: 10).

Return Value

Success: Pointer to the created SafeArray.
Failure: 0 and sets @error:
1 - Invalid number of dimensions (<= 0 or > 5).
2 - Invalid VARIANT type.
3 - Failed to create default bounds structure.
4 - Invalid $pBounds pointer.
5 - Failed to create SafeArray (DllCall failure).

Remarks

If $pBounds is 0, creates a SAFEARRAYBOUND structure with $iDefaultElements per dimension.

Related

_SafeArrayCreate, _SafeArrayDestroy, _CreateSafeArrayBounds