IAccessibleHandler::AccessibleObjectFromID メソッド (oleacc.h)

AccessibleObjectFromID メソッドは、指定されたオブジェクト ID に関連付けられているインターフェイスの IAccessible インターフェイス ポインターを取得します。 Oleacc.dll は、このメソッドを使用して、他のコードによって提供されるプロキシの IAccessible インターフェイス ポインターを取得します。

構文

HRESULT AccessibleObjectFromID(
  [in]  long         hwnd,
  [in]  long         lObjectID,
  [out] LPACCESSIBLE *pIAccessible
);

パラメーター

[in] hwnd

型: long

IAccessible インターフェイス ポインターを取得するウィンドウのハンドルを指定します。

[in] lObjectID

型: long

オブジェクト ID を指定します。 この値は、標準の オブジェクト識別子 定数またはカスタム オブジェクト ID のいずれかです。

[out] pIAccessible

種類: LPACCESSIBLE*

オブジェクトの IAccessible インターフェイスのアドレスを受け取るポインター変数のアドレスを指定します。

戻り値

型: HRESULT

成功した場合は、S_OK を返します。

成功しなかった場合は、次のいずれかの標準 COM エラー コードを返します。

解説

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 を使用してオブジェクトを作成し、 IAccessibleHandler インターフェイス ポインターを取得し、その上で AccessibleObjectFromID を呼び出して IAccessible インターフェイス ポインターを取得します。

他 の IAccessible メソッドや関数と同様に、クライアントはユーザー アクションのために IAccessible インターフェイス ポインターのエラーを受け取る可能性があります。 詳細については、「 IAccessible インターフェイス ポインターのエラーの受信」を参照してください。

要件