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