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