Metode IAccPropServices::ComposeHwndIdentityString (oleacc.h)
Penelepon menggunakan ComposeHwndIdentityString untuk mengambil string identitas.
Sintaks
HRESULT ComposeHwndIdentityString(
[in] HWND hwnd,
[in] DWORD idObject,
[in] DWORD idChild,
[out] BYTE **ppIDString,
[out] DWORD *pdwIDStringLen
);
Parameter
[in] hwnd
Jenis: HWND
Menentukan HWND dari elemen yang dapat diakses yang ingin diidentifikasi oleh pemanggil.
[in] idObject
Jenis: DWORD
Menentukan ID objek dari elemen yang dapat diakses.
[in] idChild
Jenis: DWORD
Menentukan ID anak dari elemen yang dapat diakses.
[out] ppIDString
Jenis: BYTE**
Penunjuk ke buffer yang menerima string identitas. Penerima panggilan mengalokasikan buffer ini menggunakan CoTaskMemAlloc. Setelah selesai, pemanggil harus membebaskan buffer dengan memanggil CoTaskMemFree.
[out] pdwIDStringLen
Jenis: DWORD*
Penunjuk ke buffer yang menerima panjang string identitas.
Mengembalikan nilai
Jenis: HRESULT
Jika berhasil, mengembalikan S_OK.
Mengembalikan E_INVALIDARG jika hwnd, idObject, atau idChild tidak valid.
Dapat mengembalikan kode kesalahan lain dalam kondisi kesalahan yang luar biasa seperti memori rendah.
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 |