System.VarUtils.SafeArrayRedim

De RAD Studio API Documentation
Aller à : navigation, rechercher

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é.

Voir aussi