Metode IAccessibleHandler::AccessibleObjectFromID (oleacc.h)

Artikel
03/05/2024

Metode AccessibleObjectFromID mengambil penunjuk antarmuka IAccessible untuk antarmuka yang terkait dengan ID objek yang diberikan. Oleacc.dll menggunakan metode ini untuk mendapatkan penunjuk antarmuka IAccessible untuk proksi yang disediakan oleh kode lain.

CatatanIAccessibleHandler::AccessibleObjectFromID tidak digunakan lagi dan tidak boleh digunakan.

Sintaks

HRESULT AccessibleObjectFromID(
  [in]  long         hwnd,
  [in]  long         lObjectID,
  [out] LPACCESSIBLE *pIAccessible
);

Parameter

[in] hwnd

Jenis: panjang

Menentukan handel jendela tempat penunjuk antarmuka IAccessible akan diambil.

[in] lObjectID

Jenis: panjang

Menentukan ID objek. Nilai ini adalah salah satu konstanta pengidentifikasi objek standar atau ID objek kustom.

[out] pIAccessible

Jenis: LPACCESSIBLE*

Menentukan alamat variabel pointer yang menerima alamat antarmuka IAccessible objek.

Nilai kembali

Jenis: HRESULT

Jika berhasil, mengembalikan S_OK.

Jika tidak berhasil, mengembalikan salah satu dari kode kesalahan COM standar berikut atau lainnya.

Kesalahan	Deskripsi
E_INVALIDARG	Argumen tidak valid.
E_NOINTERFACE	Antarmuka yang diminta tidak didukung.

Keterangan

Oleacc memanggil fungsi ini untuk mendapatkan penunjuk antarmuka IAccessible untuk HWNDs yang memiliki nama kelas tempat handler ini didaftarkan.

Saat startup, Oleacc melihat kunci registri HKLM\SOFTWARE\Microsoft\Active Accessibility\Handlers dan menghitung setiap subkuntang (Oleacc mengharapkan subkuncu menjadi GUID). Oleacc membaca nama kelas terkait dari HKCR\CLSID{guid}\AccClassName, di mana {guid} adalah GUID yang ditemukan di bawah kunci HKLM\SOFTWARE\Microsoft\Active Accessibility\Handlers. Ketika Oleacc menemukan jendela dengan nama kelas yang cocok dengan GUID, Oleacc Membuat bersama objek menggunakan GUID, mengambil penunjuk antarmuka IAccessibleHandler , dan memanggil AccessibleObjectFromID di dalamnya untuk mendapatkan penunjuk antarmuka IAccessible .

Seperti metode dan fungsi IAccessible lainnya, klien mungkin menerima kesalahan untuk penunjuk antarmuka IAccessible karena tindakan pengguna. Untuk informasi selengkapnya, lihat Menerima Kesalahan untuk Penunjuk Antarmuka IAccessible.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	oleacc.h
Pustaka	Oleacc.lib
DLL	Oleacc.dll
Redistribusi	Aksesibilitas Aktif 1.3 RDK di Windows NT 4.0 dengan SP6 dan yang lebih baru dan Windows 95

Bagikan melalui