AccessibleObjectFromWindow 函数 (oleacc.h)
检索与指定窗口关联的对象的指定接口的地址。
语法
HRESULT AccessibleObjectFromWindow(
[in] HWND hwnd,
[in] DWORD dwId,
[in] REFIID riid,
[out] void **ppvObject
);
参数
[in] hwnd
类型： HWND
指定要为其检索对象的窗口的句柄。 若要检索指向游标或插入点对象的接口指针，请指定 NULL 并在 dwObjectID 中使用相应的对象 ID。
[in] dwId
类型： DWORD
指定对象 ID。 此值是标准 对象标识符 常量之一或自定义对象 ID，如 OBJID_NATIVEOM，它是 Office 本机对象模型的对象 ID。 有关 OBJID_NATIVEOM的详细信息，请参阅本主题中的“备注”部分。
[in] riid
类型： REFIID
指定所请求接口的引用标识符。 此值IID_IAccessible或IID_IDispatch，但也可以是IID_IUnknown，也可以是对象应支持的任何接口的 IID。
[out] ppvObject
类型： void**
接收指定接口地址的指针变量的地址。
返回值
类型： STDAPI
如果成功，则返回 S_OK。
如果未成功，则返回以下代码之一或另一个标准 COM 错误代码。
| 返回代码 | 说明 |
|---|---|
|
自变量无效。 |
|
不支持请求的接口。 |
注解
客户端调用此函数以检索对象的 IAccessible、 IDispatch、 IEnumVARIANT、 IUnknown 或其他受支持的接口指针的地址。
与其他 IAccessible 方法和函数一样，由于用户操作，客户端可能会收到 IAccessible 接口指针错误。 有关详细信息，请参阅 接收 IAccessible 接口指针的错误。
客户端使用此函数获取对 Microsoft Office 2000 本机对象模型的访问权限。 本机对象模型为客户端提供有关 Office 应用程序文档或工作区的辅助功能信息，而 Microsoft Active Accessibility 不会公开这些信息。
若要获取指向本机对象模型支持的类的 IDispatch 接口指针，请在 dwObjectID 中指定 OBJID_NATIVEOM。 使用此对象标识符时， hwnd 参数必须与以下窗口类类型匹配。
| Office 应用程序 | Window 类 | 指向 的 IDispatch 指针 |
|---|---|---|
| Word | _WwG | 窗口 |
| Excel | EXCEL7 | 窗口 |
| PowerPoint | paneClassDC | DocumentWindow |
| 命令栏 | MsoCommandBar | CommandBar |
请注意，上述窗口类对应于最内部的文档窗口或窗格窗口。 有关 Office 对象模型的详细信息，请参阅 Microsoft Office 2000/Visual Basic 程序员指南。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | 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 |