Metode IAccPropServices::SetPropServer (oleacc.h)
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 |