SafeArrayDestroyData, fonction (oleauto.h)

Détruit toutes les données du tableau sécurisé spécifié.

Syntaxe

HRESULT SafeArrayDestroyData(
  [in] SAFEARRAY *psa
);

Paramètres

[in] psa

Descripteur de tableau sécurisé.

Valeur retournée

Cette fonction peut retourner l’une de ces valeurs.

Code de retour	Description
S_OK	Réussite.
E_INVALIDARG	L’argument psa n’était pas valide.
DISP_E_ARRAYISLOCKED	Le tableau est verrouillé.

Remarques

Cette fonction est généralement utilisée lors de la libération de tableaux sécurisés qui contiennent des éléments avec des types de données autres que des variantes. Si des objets sont stockés dans le tableau, Release est appelé sur chaque objet du tableau. Les tableaux fiables de variant auront la fonction VariantClear appelée sur chaque membre et les tableaux fiables de BSTR auront la fonction SysFreeString appelée sur chaque élément. IRecordInfo ::RecordClear est appelé pour libérer les références d’objet et d’autres valeurs d’un enregistrement sans allouer l’enregistrement.

Configuration requise

Condition requise	Valeur
Plateforme cible	Windows
En-tête	oleauto.h
Bibliothèque	OleAut32.lib
DLL	OleAut32.dll