System.VarUtils.SafeArrayRedim
Delphi
function SafeArrayRedim(VarArray: PVarArray; const NewBound: TVarArrayBound): HRESULT;
function SafeArrayRedim(VarArray: PVarArray; NewBound: PVarArrayBound): HRESULT; external oleaut name 'SafeArrayRedim';
Propriétés
Type | Visibilité | Source | Unité | Parent |
---|---|---|---|---|
function | public | System.VarUtils.pas | System.VarUtils | System.VarUtils |
Description
Change l'information de limite pour la dernière dimension d'un tableau sécurisé.
SafeArrayRedim redimensionne le tableau sécurisé donné dans le paramètre VarArray, en changeant l'information de limite pour la dernière dimension du tableau, selon le paramètre NewBound. VarArray est un pointeur sur le tableau sécurisé.
Les valeurs de retour possibles de SafeArrayRedim sont listées dans le tableau suivant, ainsi que leur signification.
Valeur | Signification |
---|---|
VAR_OK |
L'opération s'est terminée avec succès. |
VAR_INVALIDARG |
L'argument donné est nil. |
VAR_ARRAYISLOCKED |
Le tableau donné dans VarArray est verrouillé. |
VAR_EXCEPTION |
L'application a déclenché une exception. |
VAR_OUTOFMEMORY |
Mémoire insuffisante pour achever l'opération. |
Quand l'opération de redimensionnement a eu lieu, les éléments existants du tableau sont préservés et les nouveaux éléments sont initialisés à zéro ou sont vides.
Remarque : Un tableau sécurisé ne peut pas être redimensionné alors qu'il est verrouillé.