Metode IAccIdentity::GetIdentityString (oleacc.h)

Artikel
08/25/2023

Mengambil string byte (string identitas) yang secara unik mengidentifikasi elemen yang dapat diakses.

Jika pengembang server mengetahui HWND objek yang ingin mereka anotasi, mereka dapat menggunakan salah satu metode berikut alih-alih menggunakan metode ini dan mendapatkan string identitas.

Sintaks

HRESULT GetIdentityString(
  [in]  DWORD dwIDChild,
  [out] BYTE  **ppIDString,
  [out] DWORD *pdwIDStringLen
);

Parameter

[in] dwIDChild

Jenis: DWORD

Menentukan anak dari objek IAccessible mana yang ingin diidentifikasi oleh pemanggil.

[out] ppIDString

Jenis: BYTE**

Alamat variabel yang menerima penunjuk ke string identitas yang dialokasikan callee. Penerima panggilan mengalokasikan string identitas menggunakan CoTaskMemAlloc; pemanggil harus merilis string identitas dengan menggunakan CoTaskMemFree setelah selesai.

[out] pdwIDStringLen

Jenis: DWORD*

Alamat variabel yang menerima panjang, dalam byte, dari string identitas yang dialokasikan callee.

Nilai kembali

Jenis: HRESULT

Mengembalikan S_OK, kecuali dalam kondisi kesalahan yang luar biasa, seperti memori rendah. Jika tidak didukung, memanggil QueryInterface di IAccIdentity akan gagal.

Keterangan

String yang dikembalikan harus dianggap buram; klien harus menggunakannya hanya secara keseluruhan, dan tidak boleh mencoba membedahnya atau menafsirkannya secara manual.

Jika klien mengetahui atau mengharapkan bahwa string adalah HWND—berdasarkan, klien dapat menggunakan IAccPropServices::D ecomposeHwndIdentityString untuk mencoba menguraikan string identitas.

Persyaratan


Klien minimum yang didukung	Windows Vista atau Windows XP
Server minimum yang didukung	Windows Server 2003
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