IAccessibleHandler
COM公式ドキュメント
オブジェクト ID からアクセシブルな要素を取得するメソッドを公開します。
メソッド 1
vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。
AccessibleObjectFromID メソッドは、指定されたオブジェクト ID に関連付けられたインターフェースの IAccessible インターフェースポインターを取得します。Oleacc.dll はこのメソッドを使用して、他のコードによって提供されるプロキシの IAccessible インターフェースポインターを取得します。
| hwnd | INT | in | IAccessible インターフェースポインターを取得する対象のウィンドウのハンドルを指定します。 |
| lObjectID | INT | in | オブジェクト ID を指定します。この値は、標準の オブジェクト識別子 定数の 1 つ、またはカスタムのオブジェクト ID です。 |
| pIAccessible | IAccessible** | out | オブジェクトの IAccessible インターフェースのアドレスを受け取るポインター変数のアドレスを指定します。 |
戻り値
Type: HRESULT
成功した場合は S_OK を返します。
成功しなかった場合は、以下のいずれか、または別の標準的な COM エラーコード を返します。
| エラー | 説明 |
|---|---|
| 引数が無効です。 | |
| 要求されたインターフェースはサポートされていません。 |
解説(Remarks)
Oleacc は、このハンドラーが登録されているクラス名を持つ HWND の IAccessible インターフェースポインターを取得するために、この関数を呼び出します。
起動時に、Oleacc はレジストリキー HKLM\SOFTWARE\Microsoft\Active Accessibility\Handlers を参照し、各サブキーを列挙します(Oleacc はサブキーが GUID であることを想定しています)。Oleacc は、HKCR\CLSID{guid}\AccClassName から関連付けられたクラス名を読み取ります。ここで {guid} は、HKLM\SOFTWARE\Microsoft\Active Accessibility\Handlers キーの下で見つかった GUID です。Oleacc が GUID に一致するクラス名を持つウィンドウを見つけると、その GUID を使用してオブジェクトを CoCreate し、IAccessibleHandler インターフェースポインターを取得して、それに対して AccessibleObjectFromID を呼び出すことで IAccessible インターフェースポインターを取得します。
他の IAccessible メソッドや関数と同様に、クライアントはユーザーの操作によって IAccessible インターフェースポインターに対するエラーを受け取ることがあります。詳細については、Receiving Errors for IAccessible Interface Pointers を参照してください。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
HSP用 COM定義
#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。
#define global IID_IAccessibleHandler "{03022430-ABC4-11D0-BDE2-00AA001A1953}"
#usecom global IAccessibleHandler IID_IAccessibleHandler "{}"
#comfunc global IAccessibleHandler_AccessibleObjectFromID 3 int,int,sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。