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

Статья
03/05/2024

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

Синтаксис

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, если массив не удалось создать.

Требования

Требование	Значение
Целевая платформа	Windows
Header	oleauto.h
Библиотека	OleAut32.lib
DLL	OleAut32.dll

Поделиться через