SafeArrayRedim-Funktion (oleauto.h)

Artikel
03/06/2024

Ä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

Freigeben über