SafeArrayCreateVectorEx-Funktion (oleauto.h)

  • Artikel

Erstellt und gibt ein eindimensionales sicheres Array des angegebenen VARTYPE und der angegebenen Begrenzungen zurück.

Syntax

SAFEARRAY * SafeArrayCreateVectorEx(
  [in] VARTYPE vt,
  [in] LONG    lLbound,
  [in] ULONG   cElements,
  [in] PVOID   pvExtra
);

Parameter

[in] vt

Der Basistyp des Arrays (der VARTYPE jedes Elements des Arrays). Das FADF_RECORD-Flag kann für VT_RECORD festgelegt werden. Die FADF_HAVEIID kann für VT_DISPATCH oder VT_UNKNOWN und FADF_HAVEVARTYPE für alle anderen Typen festgelegt werden.

[in] lLbound

Die untere Grenze für das Array. Dieser Parameter kann negativ sein.

[in] cElements

Die Anzahl der Elemente im Array.

[in] pvExtra

Die Typinformationen des benutzerdefinierten Typs, wenn Sie ein sicheres Array von benutzerdefinierten Typen erstellen. Wenn der vt-Parameter VT_RECORD ist, ist pvExtra ein Zeiger auf eine IRecordInfo,die den Datensatz beschreibt. Wenn der vt-Parameter VT_DISPATCH oder VT_UNKNOWN ist, enthält pvExtra einen Zeiger auf eine GUID, der den Schnittstellentyp darstellt, der an das Array übergeben wird.

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