SafeArrayCreate-Funktion (oleauto.h)

Erstellt einen neuen Arraydeskriptor, ordnet und initialisiert die Daten für das Array und gibt einen Zeiger auf den neuen Arraydeskriptor zurück.

Syntax

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

Parameter

[in] vt

Der Basistyp des Arrays (VARTYPE jedes Elements des Arrays). VARTYPE ist auf eine Teilmenge der Variantentypen beschränkt. Weder das VT_ARRAY noch das VT_BYREF-Flag kann festgelegt werden. VT_EMPTY und VT_NULL sind keine gültigen Basistypen für das Array. Alle anderen Typen sind legal.

[in] cDims

Die Anzahl der Dimensionen im Array. Die Nummer kann nicht geändert werden, nachdem das Array erstellt wurde.

[in] rgsabound

Ein Vektor von Grenzen (einer für jede Dimension), der für das Array zugeordnet werden soll.

Rückgabewert

Ein sicherer Arraydeskriptor oder NULL, wenn das Array nicht erstellt werden konnte.

Anforderungen