SafeArrayCreate-Funktion (oleauto.h)

  • Artikel

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

Anforderung Wert
Zielplattform Windows
Kopfzeile oleauto.h
Bibliothek OleAut32.lib
DLL OleAut32.dll