IUIAutomation::RemoveStructureChangedEventHandler method (uiautomationclient.h)

  • Artikel

Menghapus penanganan aktivitas yang diubah struktur.

Sintaks

HRESULT RemoveStructureChangedEventHandler(
  [in] IUIAutomationElement                      *element,
  [in] IUIAutomationStructureChangedEventHandler *handler
);

Parameter

[in] element

Jenis: IUIAutomationElement*

Penunjuk ke elemen Automation UI untuk menghapus handler.

[in] handler

Jenis: IUIAutomationStructureChangedEventHandler*

Penunjuk ke antarmuka yang diteruskan ke IUIAutomation::AddStructureChangedEventHandler.

Nilai kembali

Jenis: HRESULT

Jika metode ini berhasil, metode ini mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Klien Automation UI tidak boleh menggunakan beberapa utas untuk menambahkan atau menghapus penanganan aktivitas. Perilaku tak terduga dapat mengakibatkan satu penanganan aktivitas ditambahkan atau dihapus saat yang lain sedang ditambahkan atau dihapus dalam proses klien yang sama.

Dimungkinkan bagi peristiwa untuk dikirimkan ke penanganan aktivitas setelah handler berhenti berlangganan, jika peristiwa diterima secara bersamaan dengan permintaan untuk berhenti berlangganan acara. Praktik terbaik adalah mengikuti standar Model Objek Komponen (COM) dan menghindari penghancurkan objek penanganan aktivitas hingga jumlah referensinya mencapai nol. Menghancurkan penanganan aktivitas segera setelah berhenti berlangganan peristiwa dapat mengakibatkan pelanggaran akses jika suatu peristiwa dikirim terlambat.

Persyaratan

   
Klien minimum yang didukung Windows 7, Windows Vista dengan SP2 dan Pembaruan Platform untuk Windows Vista, Windows XP dengan SP3 dan Pembaruan Platform untuk Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2008 R2, Windows Server 2008 dengan SP2 dan Pembaruan Platform untuk Windows Server 2008, Windows Server 2003 dengan SP2 dan Pembaruan Platform untuk Windows Server 2008 [hanya aplikasi desktop]
Target Platform Windows
Header uiautomationclient.h (termasuk UIAutomation.h)

Lihat juga

IUIAutomation

RemoveAllEventHandlers

RemoveAutomationEventHandler

RemoveFocusChangedEventHandler

RemovePropertyChangedEventHandler