Metode IAccPropServices::SetHwndPropServer (oleacc.h)

Artikel
03/05/2024

Metode ini membungkus SetPropServer, menyediakan titik masuk yang nyaman untuk pemanggil yang menganotasi elemen yang dapat diakses berbasis HWND.

Sintaks

HRESULT SetHwndPropServer(
  [in] HWND             hwnd,
  [in] DWORD            idObject,
  [in] DWORD            idChild,
  [in] const MSAAPROPID *paProps,
  [in] int              cProps,
  [in] IAccPropServer   *pServer,
  [in] AnnoScope        annoScope
);

Parameter

[in] hwnd

Jenis: HWND

Mengidentifikasi elemen yang dapat diakses yang akan diannotasi. Ini menggantikan string identitas.

[in] idObject

Jenis: DWORD

Mengidentifikasi elemen yang dapat diakses yang akan diannotasi. Ini menggantikan string identitas.

[in] idChild

Jenis: DWORD

Mengidentifikasi elemen yang dapat diakses yang akan diannotasi. Ini menggantikan string identitas.

[in] paProps

Jenis: const MSAAPROPID*

Menentukan array properti yang akan ditangani oleh objek panggilan balik yang ditentukan.

[in] cProps

Jenis: int

Menentukan jumlah properti dalam array paProps .

[in] pServer

Jenis: IAccPropServer*

Menentukan objek panggilan balik, yang akan dipanggil ketika klien meminta salah satu properti yang ditimpa.

[in] annoScope

Jenis: AnnoScope

Mungkin ANNO_THIS, menunjukkan bahwa anotasi hanya memengaruhi elemen yang dapat diakses yang ditunjukkan; atau ANNO_CONTAINER, menunjukkan bahwa itu berlaku untuk elemen dan elemen elemen langsungnya.

Mengembalikan nilai

Jenis: HRESULT

Jika berhasil, mengembalikan S_OK.

Mengembalikan E_INVALIDARG jika salah satu properti dalam array paProps tidak didukung properti, jika string identitas tidak valid, atau jika annoScope bukan salah satu dari ANNO_THIS atau ANNO_CONTAINER.

Dapat mengembalikan kode kesalahan lain dalam kondisi kesalahan yang luar biasa seperti memori rendah.

Keterangan

Dengan menggunakan metode ini, penelepon tidak harus mendapatkan string identitas; ini dapat menentukan parameter hwnd, idObject, dan idChild secara langsung.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	oleacc.h (sertakan OleAcc.h Include Initguid.h first.)
DLL	Oleacc.dll
Redistribusi	Aksesibilitas Aktif 2.0 RDK di Windows NT 4.0 dengan SP6 dan yang lebih baru dan Windows 98