Metode IAccPropServices::ClearProps (oleacc.h)

  • Artikel

Server menggunakan ClearProps untuk memulihkan nilai default ke properti elemen yang dapat diakses yang sebelumnya telah mereka anotasi.

Jika server mengetahui HWND objek yang ingin dihapus, mereka dapat menggunakan IAccPropServices::ClearHwndProps.

Sintaks

HRESULT ClearProps(
  [in] const BYTE       *pIDString,
  [in] DWORD            dwIDStringLen,
  [in] const MSAAPROPID *paProps,
  [in] int              cProps
);

Parameter

[in] pIDString

Jenis: const BYTE*

Identifikasi elemen yang dapat diakses yang tidak akan dianotasi.

[in] dwIDStringLen

Jenis: DWORD

Panjang pIDString.

[in] paProps

Jenis: const MSAAPROPID*

Tentukan array properti yang akan direset. Properti ini akan kembali ke perilaku default yang ditampilkan sebelum dianotasi.

[in] cProps

Jenis: int

Ukuran array paProps .

Nilai kembali

Jenis: HRESULT

Jika berhasil, mengembalikan S_OK, bahkan jika properti yang ditentukan tidak pernah diannotasikan pada objek yang dapat diakses; menghapus properti yang sudah dibersihkan dianggap berhasil.

Mengembalikan E_INVALIDARG jika salah satu properti dalam array paProps tidak didukung.

Dapat mengembalikan kode kesalahan lain dalam kondisi kesalahan yang luar biasa seperti memori rendah.

Keterangan

Lihat bagian dukungan untuk daftar properti yang didukung dan jenis yang diharapkan.

Menghapus anotasi untuk properti akan menyebabkan sumber daya terkait dirilis. Jika server properti panggilan balik digunakan (lihat SetPropServer), server akan dirilis.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows XP [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2003 [hanya aplikasi desktop]
Target Platform Windows
Header oleacc.h (termasuk OleAcc.h Include Initguid.h first.)
DLL Oleacc.dll
Redistribusi Aksesibilitas Aktif 2.0 RDK pada Windows NT 4.0 dengan SP6 dan yang lebih baru dan Windows 98