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 CoCreate 对象,检索 IAccessibleHandler 接口指针,并调用其上的 AccessibleObjectFromID 以获取 IAccessible 接口指针。
与其他 IAccessible 方法和函数一样,由于用户操作,客户端可能会收到 IAccessible 接口指针错误。 有关详细信息,请参阅 接收 IAccessible 接口指针的错误。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
目标平台 | Windows |
标头 | oleacc.h |
Library | Oleacc.lib |
DLL | Oleacc.dll |
可再发行组件 | 具有 SP6 及更高版本和 Windows 95 的 Windows NT 4.0 上的 Active Accessibility 1.3 RDK |