Функция SafeArrayCreate (oleauto.h)

Создает новый дескриптор массива, выделяет и инициализирует данные для массива и возвращает указатель на новый дескриптор массива.

Синтаксис

SAFEARRAY * SafeArrayCreate(
  [in] VARTYPE        vt,
  [in] UINT           cDims,
  [in] SAFEARRAYBOUND *rgsabound
);

Параметры

[in] vt

Базовый тип массива (VARTYPE каждого элемента массива). VARTYPE ограничен подмножеством типов вариантов. Невозможно установить ни VT_ARRAY, ни флаг VT_BYREF. VT_EMPTY и VT_NULL не являются допустимыми базовыми типами для массива. Все остальные типы являются законными.

[in] cDims

Число измерений в массиве. Номер нельзя изменить после создания массива.

[in] rgsabound

Вектор границ (по одному для каждого измерения), выделяемый для массива.

Возвращаемое значение

Безопасный дескриптор массива или значение NULL, если массив не удалось создать.

Требования