Metode IAccPropServices::ClearHwndProps (oleacc.h)

Metode ini membungkus SetPropValue, SetPropServer, dan ClearProps, dan menyediakan titik masuk yang nyaman untuk penelepon yang menganotasi elemen yang dapat diakses berbasis HWND.

Sintaks

HRESULT ClearHwndProps(
  [in] HWND             hwnd,
  [in] DWORD            idObject,
  [in] DWORD            idChild,
  [in] const MSAAPROPID *paProps,
  [in] int              cProps
);

Parameter

[in] hwnd

Jenis: HWND

Mengidentifikasi elemen yang dapat diakses yang akan diannotasi. Ini menggantikan string identitas.

[in] idObject

Jenis: DWORD

Mengidentifikasi elemen yang dapat diakses yang akan diannotasi. Ini menggantikan string identitas.

[in] idChild

Jenis: DWORD

Mengidentifikasi elemen yang dapat diakses yang akan diannotasi. Ini menggantikan string identitas.

[in] paProps

Jenis: const MSAAPROPID*

Menentukan array properti yang akan direset. Properti ini akan kembali ke perilaku default yang ditampilkan sebelum diannotasi.

[in] cProps

Jenis: int

Menentukan jumlah properti dalam array paProps .

Mengembalikan nilai

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.

Untuk deskripsi nilai yang dikembalikan, lihat metode SetPropValue, SetPropServer, atau ClearProps yang sesuai.

Keterangan

Dengan menggunakan metode ini, pemanggil tidak harus mendapatkan string identitas; ini dapat menentukan parameter hwnd, idObject, dan idChild secara langsung.

Selain itu, SetHwndPropStr mengambil untai (karakter) Unicode reguler sebagai parameter; penelepon tidak perlu mengalokasikan BSTR secara khusus.

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

Lihat juga

ClearProps

IAccPropServices

SetHwndProp

SetHwndPropServer

SetHwndPropStr