Función SafeArrayCreate (oleauto.h)

Crea un nuevo descriptor de matriz, asigna e inicializa los datos de la matriz y devuelve un puntero al nuevo descriptor de matriz.

Sintaxis

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

Parámetros

[in] vt

Tipo base de la matriz (vartype de cada elemento de la matriz). VARTYPE está restringido a un subconjunto de los tipos de variante. Ni se puede establecer el VT_ARRAY ni la marca VT_BYREF. VT_EMPTY y VT_NULL no son tipos base válidos para la matriz. Todos los otros tipos son legales.

[in] cDims

Número de dimensiones de la matriz. El número no se puede cambiar después de crear la matriz.

[in] rgsabound

Vector de límites (uno para cada dimensión) que se va a asignar para la matriz.

Valor devuelto

Descriptor de matriz seguro o null si no se pudo crear la matriz.

Requisitos

Requisito Value
Plataforma de destino Windows
Encabezado oleauto.h
Library OleAut32.lib
Archivo DLL OleAut32.dll