System.VarUtils.SafeArrayRedim

• Übergeordnet: System.VarUtils

Delphi

function SafeArrayRedim(VarArray: PVarArray; const NewBound: TVarArrayBound): HRESULT;
function SafeArrayRedim(VarArray: PVarArray; NewBound: PVarArrayBound): HRESULT; external oleaut name 'SafeArrayRedim';

Eigenschaften

Typ	Sichtbarkeit	Quelle	Unit	Übergeordnet
function	public	System.VarUtils.pas	System.VarUtils	System.VarUtils

Beschreibung

Ändert die Größeninformation für die letzte Dimension eines sicheren Arrays.

SafeArrayRedim ändert die Größe des im Parameter VarArray angegebenen sicheren Arrays, indem die Größeninformation für die letzte Dimension des Array entsprechend dem Parameter NewBound geändert wird. VarArray ist ein Zeiger auf das sichere Array.

Die möglichen Rückgabewerte von SafeArrayRedim sind zusammen mit ihrer Bedeutung in der folgenden Tabelle aufgeführt.

Wert	Bedeutung
VAR_OK	Die Operation wurde erfolgreich abgeschlossen.
VAR_INVALIDARG	Das gegebene Argument ist nil.
VAR_ARRAYISLOCKED	Das in VarArray angegebene Array ist gesperrt.
VAR_EXCEPTION	Die Anwendung hat eine Exception ausgelöst.
VAR_OUTOFMEMORY	Für die Durchführung der Operation ist nicht genügend Speicher vorhanden.

Nach der Größenänderung werden die vorhanden Elemente des Arrays beibehalten, und die neuen Elemente werden auf Null oder Leer gesetzt.

Anmerkung:  Die Größe eines sicheren Arrays kann nicht geändert werden, während es gesperrt ist.

Siehe auch

• SafeArrayLock

• SafeArrayUnlock