SafeArrayRedim-Funktion (oleauto.h)

  • Artikel

Ändert die grenze des angegebenen sicheren Arrays mit der geringsten (geringsten Bedeutung).

Syntax

HRESULT SafeArrayRedim(
  [in, out] SAFEARRAY      *psa,
  [in]      SAFEARRAYBOUND *psaboundNew
);

Parameter

[in, out] psa

Ein sicherer Arraydeskriptor.

[in] psaboundNew

Eine neue sichere Array-gebundene Struktur, die die neue Arraygrenze enthält. Sie können nur die geringstmögliche Dimension eines Arrays ändern.

Rückgabewert

Diese Funktion kann einen dieser Werte zurückgeben.

Rückgabecode BESCHREIBUNG
S_OK
 Erfolg.
E_INVALIDARG
 Das Argument psa ist ungültig.
DISP_E_ARRAYISLOCKED
 Das Array ist gesperrt.

Hinweise

Wenn Sie die Begrenzung eines Arrays verringern, entfernt SafeArrayRedim die Zuordnung der Arrayelemente außerhalb der neuen Arraygrenze. Wenn die Begrenzung eines Arrays erhöht wird, ordnet SafeArrayRedim die neuen Arrayelemente zu und initialisiert sie. Die Daten werden für Elemente beibehalten, die sowohl im alten als auch im neuen Array vorhanden sind.

Anforderungen

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