IAccessibleHandler::AccessibleObjectFromID 方法 (oleacc.h)
AccessibleObjectFromID 方法會擷取與指定物件標識符相關聯之介面的 IAccessible 介面指標。 Oleacc.dll 使用此方法來取得其他程式碼所提供 Proxy 的 IAccessible 介面指標。
語法
HRESULT AccessibleObjectFromID(
[in] long hwnd,
[in] long lObjectID,
[out] LPACCESSIBLE *pIAccessible
);
參數
[in] hwnd
類型: long
指定要擷取 IAccessible 介面指標之視窗的句柄。
[in] lObjectID
類型: long
指定物件識別碼。 這個值是其中一個標準 對象標識碼 常數或自定義物件標識碼。
[out] pIAccessible
類型: LPACCESSIBLE*
指定接收物件 IAccessible 介面位址的指標變數位址。
傳回值
類型: HRESULT
如果成功,則傳回 S_OK。
如果未成功,則傳回下列其中一個或另一個標準 COM 錯誤碼。
錯誤 | Description |
---|---|
|
引數無效。 |
|
不支援要求的介面。 |
備註
Oleacc 會呼叫此函式,以取得 HWND的 IAccessible 介面指標,此介面指標具有此處理程式所註冊的類別名稱。
在啟動時,Oleacc 會查看登錄機碼 HKLM\SOFTWARE\Microsoft\Active Accessibility\Handlers,並列舉 Oleacc 每個子機碼, (Oleacc 預期子機碼為 GUID) 。 Oleacc 會從 HKCR\CLSID{guid}\AccClassName 讀取相關聯的類別名稱,其中 {guid} 是在 HKLM\SOFTWARE\Microsoft\Active Accessibility\Handlers 機碼下找到的 GUID。 當 Oleacc 找到類別名稱符合 GUID 的視窗時,它會使用 GUID CoCreates 物件、擷取 IAccessibleHandler 介面指標,並在其上呼叫 AccessibleObjectFromID 以取得 IAccessible 介面指標。
如同其他 IAccessible 方法和函式,用戶端可能會因為用戶動作而收到 IAccessible 介面指標的錯誤。 如需詳細資訊,請參閱 接收 IAccessible 介面指標的錯誤。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2003 [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | oleacc.h |
程式庫 | Oleacc.lib |
Dll | Oleacc.dll |
可轉散發套件 | Windows NT 4.0 上的 Active Accessibility 1.3 RDK 與 SP6 和更新版本和 Windows 95 |