SafeArrayAllocDescriptorEx-Funktion (oleauto.h)

  • Artikel

Erstellt einen sicheren Arraydeskriptor für ein Array eines beliebigen gültigen Variantentyps, einschließlich VT_RECORD, ohne die Arraydaten zuzuordnen.

Syntax

HRESULT SafeArrayAllocDescriptorEx(
  [in]  VARTYPE   vt,
  [in]  UINT      cDims,
  [out] SAFEARRAY **ppsaOut
);

Parameter

[in] vt

Der Variantentyp.

[in] cDims

Die Anzahl der Dimensionen im Array.

[out] ppsaOut

Die Beschreibung des sicheren Arrays.

Rückgabewert

Diese Funktion kann einen dieser Werte zurückgeben.

Rückgabecode BESCHREIBUNG
S_OK
 Erfolg.
E_INVALIDARG
 Das Argument psa war ungültig.

Hinweise

Da SafeArrayAllocDescriptor keinen VARTYPE verwendet, ist es nicht möglich, ihn zum Erstellen des sicheren Arraydeskriptors für ein Array von Datensätzen zu verwenden. SafeArrayAllocDescriptorEx wird verwendet, um einen sicheren Arraydeskriptor für ein Array von Datensätzen der angegebenen Dimensionen zuzuordnen.

Anforderungen

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