Metode IAccPropServices::ClearProps (oleacc.h)
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 |