SafeArrayDestroy, fonction (oleauto.h)

Détruit un descripteur de tableau existant et toutes les données du tableau. Si des objets sont stockés dans le tableau, Release est appelé sur chaque objet du tableau.

Syntaxe

HRESULT SafeArrayDestroy(
  [in] SAFEARRAY *psa
);

Paramètres

[in] psa

Descripteur de tableau créé par SafeArrayCreate.

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’est pas valide.
DISP_E_ARRAYISLOCKED
Le tableau est verrouillé.

Remarques

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.

Exemples

STDMETHODIMP_(ULONG) CEnumPoint::Release()
{
   if(--m_refs == 0){
      if(m_psa != NULL)
      SafeArrayDestroy(m_psa);
      delete this;
      return 0;
   }
   return m_refs;
}

Configuration requise

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