Metode IAccPropServices::D ecomposeHwndIdentityString (oleacc.h)

Artikel
02/29/2024

Gunakan metode ini untuk menentukan HWND, ID objek, dan ID anak untuk elemen yang dapat diakses yang diidentifikasi oleh string identitas.

Sintaks

HRESULT DecomposeHwndIdentityString(
  [in]  const BYTE *pIDString,
  [in]  DWORD      dwIDStringLen,
  [out] HWND       *phwnd,
  [out] DWORD      *pidObject,
  [out] DWORD      *pidChild
);

Parameter

[in] pIDString

Jenis: const BYTE*

Penunjuk ke buffer yang berisi string identitas dari elemen yang dapat diakses berbasis HWND.

[in] dwIDStringLen

Jenis: DWORD

Menentukan panjang string identitas yang ditentukan oleh pIDString.

[out] phwnd

Jenis: HWND*

Pointer ke buffer yang menerima HWND dari elemen yang dapat diakses.

[out] pidObject

Jenis: DWORD*

Penunjuk ke buffer yang menerima ID objek dari elemen yang dapat diakses.

[out] pidChild

Jenis: DWORD*

Penunjuk ke buffer yang menerima ID anak dari elemen yang dapat diakses.

Mengembalikan nilai

Jenis: HRESULT

Jika berhasil, mengembalikan S_OK.

Mengembalikan E_INVALIDARG jika phwnd, pidObject, atau pidChild tidak valid, atau jika string identitas yang diberikan bukan string identitas berbasis HWND.

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

Keterangan

Metode ini hanya berhasil jika string identitas yang disediakan adalah string identitas berbasis HWND. Metode ini berguna ketika digunakan dalam server panggilan balik IAccPropServer yang terdaftar dengan cakupan ANNO_CONTAINER karena memungkinkan server untuk menentukan, dari string identitas yang diberikan, elemen anak (idChild) tempat klien memanggil server.

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 (termasuk OleAcc.h Include Initguid.h first.)
DLL	Oleacc.dll
Redistribusi	Aksesibilitas Aktif 2.0 RDK pada Windows NT 4.0 dengan SP6 dan yang lebih baru dan Windows 98

Bagikan melalui