System.VarUtils.SafeArrayCreate

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

function SafeArrayCreate(VarType, DimCount: Integer; const Bounds: TVarArrayBoundArray): PVarArray;
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.

Voir aussi

Exemples de code