Metode IAccPropServices::SetPropServer (oleacc.h)

Artikel
08/25/2023

Server menggunakan SetPropServer untuk menentukan objek panggilan balik yang akan digunakan untuk membuat anotasi array properti untuk elemen yang dapat diakses. Anda juga dapat menentukan apakah anotasi akan diterapkan ke elemen yang dapat diakses ini atau ke elemen dan turunannya. Metode ini digunakan untuk anotasi server.

Jika pengembang server mengetahui HWND dari elemen yang dapat diakses yang ingin mereka anotasi, mereka dapat menggunakan IAccPropServices::SetHwndPropServer.

Sintaks

HRESULT SetPropServer(
  [in] const BYTE       *pIDString,
  [in] DWORD            dwIDStringLen,
  [in] const MSAAPROPID *paProps,
  [in] int              cProps,
  [in] IAccPropServer   *pServer,
  [in] AnnoScope        annoScope
);

Parameter

[in] pIDString

Jenis: const BYTE*

Mengidentifikasi elemen yang dapat diakses yang akan diannotasi.

[in] dwIDStringLen

Jenis: DWORD

Menentukan panjang string yang diidentifikasi oleh parameter pIDString .

[in] paProps

Jenis: const MSAAPROPID*

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

[in] cProps

Jenis: int

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

[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.

Nilai kembali

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

Lihat bagian dukungan untuk daftar properti yang didukung dan jenis yang diharapkan.

Durasi anotasi akan menggunakan AddRef untuk menambah penghitung referensi untuk objek panggilan balik pServer dengan tepat. Pemanggil bebas untuk Merilisnya setelah memanggil metode ini. Durasi anotasi akan secara otomatis merilis objek panggilan balik setelah elemen yang dapat diakses yang diannotasi tidak lagi digunakan.

Persyaratan


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

Bagikan melalui