Fungsi LresultFromObject (oleacc.h)
Mengembalikan referensi, mirip dengan handel, dengan objek yang ditentukan. Server mengembalikan referensi ini saat menangani WM_GETOBJECT.
Sintaks
LRESULT LresultFromObject(
[in] REFIID riid,
[in] WPARAM wParam,
[in] LPUNKNOWN punk
);
Parameter
[in] riid
Jenis: REFIID
Pengidentifikasi referensi antarmuka yang disediakan untuk klien. Parameter ini IID_IAccessible.
[in] wParam
Jenis: WPARAM
Nilai yang dikirim oleh pesan WM_GETOBJECT terkait dalam parameter wParam-nya .
[in] punk
Jenis: LPUNKNOWN
Alamat antarmuka IAccessible ke objek yang sesuai dengan pesan WM_GETOBJECT .
Nilai kembali
Jenis: LRESULT
Jika berhasil, mengembalikan nilai positif yang merupakan referensi ke objek .
Jika tidak berhasil, mengembalikan salah satu nilai dalam tabel berikut, atau kode kesalahan COM standar lainnya.
Menampilkan kode | Deskripsi |
---|---|
|
Satu atau beberapa argumen tidak valid. |
|
Objek yang ditentukan dalam parameter pAcc tidak mendukung antarmuka yang ditentukan dalam parameter riid . |
|
Tidak cukup memori untuk menyimpan referensi objek. |
|
Terjadi kesalahan tak terduga. |
Keterangan
Server memanggil fungsi ini hanya saat menangani pesan WM_GETOBJECT . Untuk gambaran umum tentang bagaimana LresultFromObject terkait dengan WM_GETOBJECT, lihat Cara kerja WM_GETOBJECT.
LresultFromObject menaikkan jumlah referensi objek. Jika Anda tidak menyimpan penunjuk antarmuka yang diteruskan ke fungsi (yaitu, Anda membuat penunjuk antarmuka baru untuk objek setiap kali WM_GETOBJECT diterima), panggil metode Rilis objek untuk mengurangi jumlah referensi kembali ke satu. Kemudian klien memanggil Rilis dan objek dihancurkan. Untuk informasi selengkapnya, lihat Cara Menangani WM_GETOBJECT.
Setiap kali server memproses WM_GETOBJECT untuk objek tertentu, server memanggil LresultFromObject untuk mendapatkan referensi baru ke objek. Server tidak menyimpan referensi yang dikembalikan dari LresultFromObject dari satu instans pemrosesan WM_GETOBJECT untuk digunakan sebagai nilai pengembalian pesan saat memproses pesan WM_GETOBJECT berikutnya untuk objek yang sama. Hal ini menyebabkan klien menerima kesalahan.
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 |