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 错误代码。

返回代码	说明
E_INVALIDARG	自变量无效。
E_NOINTERFACE	不支持请求的接口。

客户端调用此函数以检索对象的 IAccessible、 IDispatch、 IEnumVARIANT、 IUnknown 或其他受支持的接口指针的地址。

与其他 IAccessible 方法和函数一样，由于用户操作，客户端可能会收到 IAccessible 接口指针错误。有关详细信息，请参阅接收 IAccessible 接口指针的错误。

客户端使用此函数获取对 Microsoft Office 2000 本机对象模型的访问权限。本机对象模型为客户端提供有关 Office 应用程序文档或工作区的辅助功能信息，而 Microsoft Active Accessibility 不会公开这些信息。

若要获取指向本机对象模型支持的类的 IDispatch 接口指针，请在 dwObjectID 中指定 OBJID_NATIVEOM。使用此对象标识符时， hwnd 参数必须与以下窗口类类型匹配。

请注意，上述窗口类对应于最内部的文档窗口或窗格窗口。有关 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