Fungsi LresultFromObject (oleacc.h)

Artikel
03/08/2023

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
E_INVALIDARG	Satu atau beberapa argumen tidak valid.
E_NOINTERFACE	Objek yang ditentukan dalam parameter pAcc tidak mendukung antarmuka yang ditentukan dalam parameter riid .
E_OUTOFMEMORY	Tidak cukup memori untuk menyimpan referensi objek.
E_UNEXPECTED	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

Lihat juga

Membuat Objek Proksi

Cara Kerja WM_GETOBJECT

Cara Menangani WM_GETOBJECT

WM_GETOBJECT

Share via