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.

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