SafeArrayCreate
Dieser Dokumentation für die Vorschau nur ist und in späteren Versionen geändert. Leere Themen wurden als Platzhalter eingefügt.]
Erstellt eine neue Arraydeskriptor, reserviert und initialisiert die Daten für das Array und gibt einen Zeiger auf den neuen Arraydeskriptor.
SAFEARRAY* SafeArrayCreate(
VARTYPE vt,
unsigned int cDims,
SAFEARRAYBOUND * rgsabound
);
Parameter
vt
Der Basistyp des Arrays (VARTYPE jedes Elements des Arrays). Die VARTYPE ist auf eine Teilmenge der Varianten-Typen beschränkt. Weder das VT_BYREF-Flag als auch die VT_ARRAY kann festgelegt werden. VT_EMPTY und VT_NULL sind keine gültige Basistypen für das Array. Alle anderen Typen sind zulässig.cDims
Anzahl der Dimensionen im Array. Die Anzahl kann nicht geändert werden, nachdem das Array erstellt wurde.rgsabound
Zeiger auf ein Vektor von umschließt (eine für jede Dimension) für das Array zugewiesen werden.
Rückgabewert
Verweist auf das Arraydeskriptor oder Null, wenn das Array konnte nicht erstellt werden.
Beispiel
Das folgende Beispiel veranschaulicht -Funktion SafeArrayCreate aufrufen.
SAFEARRAY * psa;
SAFEARRAYBOUND rgsabound[1];
rgsabound[0].lLbound = 0;
rgsabound[0].cElements = 5;
psa = SafeArrayCreate(VT_VARIANT, 1, rgsabound);
if(psa == NULL)
return E_OUTOFMEMORY;
// Use the array
return NOERROR;
<MSHelp:link keywords="_psdk_requirements" TABINDEX="0">Requirements</MSHelp:link>