Share via


COleSafeArray::Create

Asigna e inicializa los datos para la matriz.

void Create(
   VARTYPE vtSrc,
   DWORD dwDims,
   DWORD* rgElements 
);
void Create(
   VARTYPE vtSrc,
   DWORD dwDims,
   SAFEARRAYBOUND* rgsabounds 
);

Parámetros

  • vtSrc
    El tipo base de la matriz (es decir, VARTYPE de cada elemento de la matriz).VARTYPE se limita a un subconjunto de tipos de variable.Ni VT_ARRAY ni la marca de VT_BYREF puede establecer.VT_EMPTY y VT_NULL son tipos base no válidos para la matriz.Todos los demás tipos son válidos.

  • dwDims
    Número de dimensiones de la matriz.Esto se puede cambiar después de que la matriz se cree con Redim.

  • rgElements
    Puntero a una matriz del número de elementos para cada dimensión de la matriz.

  • rgsabounds
    Puntero a un vector de los límites (uno para cada dimensión) a asignar para la matriz.

Comentarios

Esta función borrará los datos actuales de la matriz en caso necesario.Por error, la función produce CMemoryException.

Ejemplo

COleSafeArray saMatrix;
DWORD numElements[] = {10, 5};

// creates a 2 dimensional safearray of type VT_I2 
// with size 10x5 elements, with all indices starting at 0(default)
saMatrix.Create(VT_I2, 2, numElements);

ASSERT(saMatrix.GetDim() == 2);

COleSafeArray saVector;
SAFEARRAYBOUND rgsabounds[] = { {5, 2} };

// creates a 1 dimensional safearray of type VT_I1 
// with size 5 elements, with the index starting at 2
saVector.Create(VT_I1, 1, rgsabounds);

ASSERT(saVector.GetDim() == 1);

Requisitos

encabezado: afxdisp.h

Vea también

Referencia

Clase de COleSafeArray

Gráfico de jerarquía

SafeArrayCreate