Freigeben über


COleSafeArray::Create

Ordnet zu und initialisiert die Daten für das Array.

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

Parameter

  • vtSrc
    Der Basistyp des Arrays (das heißt, VARTYPE von jedem Element des Arrays). VARTYPE wird auf eine Teilmenge der varianten Typen beschränkt. Weder können VT_ARRAY noch das VT_BYREF-Flag festgelegt werden. VT_EMPTY und VT_NULL sind ungültige Basistypen für das Array. Alle anderen Typen sind gültig.

  • dwDims
    Anzahl der Dimensionen im Array. Dies kann geändert werden, nachdem das Array mit Redim erstellt wurde.

  • rgElements
    Zeiger auf ein Array der Anzahl von Elementen für jede Dimension im Array.

  • rgsabounds
    Zeiger auf ein Vektor für das Array zuzuordnen von den Grenzen (eine für jede Dimension).

Hinweise

Diese Funktion löscht die aktuellen erklärt. Bei einem Fehler wird die Funktion CMemoryException aus.

Beispiel

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);

Anforderungen

Header: afxdisp.h

Siehe auch

Referenz

COleSafeArray-Klasse

Hierarchiediagramm

Weitere Ressourcen

SafeArrayCreate