Fungsi SafeArrayDestroy (oleauto.h)

Menghancurkan deskriptor array yang ada dan semua data dalam array. Jika objek disimpan dalam array, Rilis dipanggil pada setiap objek dalam array.

Sintaks

HRESULT SafeArrayDestroy(
  [in] SAFEARRAY *psa
);

Parameter

[in] psa

Deskriptor array yang dibuat oleh SafeArrayCreate.

Nilai kembali

Fungsi ini dapat mengembalikan salah satu nilai ini.

Menampilkan kode	Deskripsi
S_OK	Berhasil.
E_INVALIDARG	Argumen psa tidak valid.
DISP_E_ARRAYISLOCKED	Array dikunci.

Keterangan

Array aman varian akan memiliki fungsi VariantClear yang dipanggil pada setiap anggota dan array aman BSTR akan memiliki fungsi SysFreeString yang dipanggil pada setiap elemen. IRecordInfo::RecordClear akan dipanggil untuk merilis referensi objek dan nilai lain dari rekaman tanpa membatalkan alokasi rekaman.

Contoh

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

Persyaratan

Persyaratan	Nilai
Target Platform	Windows
Header	oleauto.h
Pustaka	OleAut32.lib
DLL	OleAut32.dll