System.VarUtils.SafeArrayRedim
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.