Fungsi UiaReturnRawElementProvider (uiautomationcoreapi.h)

Mendapatkan antarmuka ke penyedia Automation UI untuk jendela.

Sintaks

LRESULT UiaReturnRawElementProvider(
  [in] HWND                      hwnd,
  [in] WPARAM                    wParam,
  [in] LPARAM                    lParam,
  [in] IRawElementProviderSimple *el
);

Parameter

[in] hwnd

Jenis: HWND

Handel jendela yang berisi elemen yang dilayani oleh penyedia.

[in] wParam

Jenis: WPARAM

Argumen wParam dari pesan WM_GETOBJECT .

[in] lParam

Jenis: LPARAM

Argumen lParam dari pesan WM_GETOBJECT .

[in] el

Jenis: IRawElementProviderSimple*

Penyedia Automasi UI.

Nilai kembali

Jenis: LRESULT

Kunci untuk proses klien untuk terhubung ke proses server melalui Automasi UI.

Fungsi ini mengembalikan nol ketika digunakan untuk memberi tahu Automasi UI bahwa aman untuk menghapus peta raised-event penyedia. Untuk informasi selengkapnya, lihat Keterangan.

Keterangan

Fungsi ini dipanggil oleh kontrol ketika menerima pesan WM_GETOBJECT , untuk menyediakan Automasi UI dengan penyedia Automation UI untuk kontrol. Kontrol harus meneruskan parameter wParam dan lParam ke fungsi UiaReturnRawElementProvider tanpa memfilternya terlebih dahulu, karena pemfilteran dapat menyebabkan masalah dengan klien Aksesibilitas Aktif Microsoft. Prosedur jendela kontrol harus mengembalikan hasil panggilan UiaReturnRawElementProvider.

Saat klien Aksesibilitas Aktif Microsoft mendengarkan peristiwa yang diangkat oleh penyedia Automation UI, UI Automation mempertahankan peta penyedia yang telah memunculkan peristiwa. Saat klien Aksesibilitas Aktif Microsoft meminta informasi lebih lanjut, Automasi UI menggunakan peta untuk merutekan permintaan ke penyedia yang sesuai. Ketika jendela yang sebelumnya dikembalikan penyedia telah dihancurkan, Anda harus memberi tahu Automasi UI dengan memanggil fungsi UiaReturnRawElementProvider sebagai berikut: UiaReturnRawElementProvider(hwnd, 0, 0, NULL). Panggilan ini memberi tahu Automation UI bahwa ia dapat dengan aman menghapus semua entri peta yang merujuk ke jendela yang ditentukan. Panggilan ini dapat menyimpan memori karena merilis referensi ke penyedia yang ditahan oleh peta raised-event. Fungsi mengembalikan nol ketika dipanggil dengan parameter khusus ini. Microsoft merekomendasikan untuk melakukan panggilan ini dari penangan pesan WM_DESTROY jendela yang mengembalikan penyedia Automation UI.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung	Windows Server 2003 [aplikasi desktop | Aplikasi UWP]
Target Platform	Windows
Header	uiautomationcoreapi.h
Pustaka	Uiautomationcore.lib
DLL	Uiautomationcore.dll