System.VarUtils.SafeArrayCreate
Delphi
function SafeArrayCreate(VarType, DimCount: Integer; const Bounds: TVarArrayBoundArray): PVarArray;
function SafeArrayCreate(VarType, DimCount: Integer; Bounds: PVarArrayBoundArray): PVarArray; external oleaut name 'SafeArrayCreate';
Propriétés
| Type | Visibilité | Source | Unité | Parent |
|---|---|---|---|---|
| function | public | System.VarUtils.pas | System.VarUtils | System.VarUtils |
Description
Crée un tableau sécurisé.
Utilisez SafeArrayCreate pour créer un tableau sécurisé avec les paramètres donnés.
Le paramètre VarType donne le type de chaque élément du tableau sécurisé. Utilisez les constantes var... (varInteger, varBoolean, varDate, varCurrency, et ainsi de suite) dans l'unité System pour spécifier le type variant des éléments.
Le paramètre DimCount donne le nombre de dimensions du tableau sécurisé. DimCount représente aussi le nombre d'éléments du tableau de constantes Bounds.
Bounds est un type TVarArrayBoundArray de constante donnant les informations de limites du tableau sécurisé, dans toutes ses dimensions.
Afin de créer le tableau sécurisé, la routine SafeArrayCreate vérifie d'abord si le type d'élément est valide, puis alloue de la mémoire pour le descripteur du tableau sécurisé à l'aide de la fonction SafeArrayAllocDescriptor. Enfin, elle tente d'allouer de la mémoire pour les données réelles du tableau sécurisé, en utilisant SafeArrayAllocData. En cas d'échec, elle détruit alors le descripteur préalablement alloué à l'aide de la routine SafeArrayDestroyDescriptor.
Si SafeArrayCreate est gérée pour créer le tableau sécurisé, elle renvoie alors un pointeur sur le tableau en tant que variable de type PVarArray. Dans le cas où SafeArrayCreate n'est pas gérée pour créer le tableau sécurisé, elle renvoie simplement nil.
Pour détruire un tableau sécurisé, utilisez la fonction SafeArrayDestroy.