AccessibleObjectFromWindow 函式 (oleacc.h)

擷取與指定視窗相關聯之物件的指定介面位址。

語法

HRESULT AccessibleObjectFromWindow(
  [in]  HWND   hwnd,
  [in]  DWORD  dwId,
  [in]  REFIID riid,
  [out] void   **ppvObject
);

[in] hwnd

類型： HWND

指定要擷取物件的視窗句柄。若要擷取數據指標或插入號物件的介面指標，請指定 NULL ，並在 dwObjectID 中使用適當的對象識別碼。

[in] dwId

類型： DWORD

指定物件識別碼。這個值是其中一個標準對象標識碼常數或自定義物件標識符，例如 OBJID_NATIVEOM，這是 Office 原生物件模型的物件識別碼。如需 OBJID_NATIVEOM的詳細資訊，請參閱本主題中的一節。

[in] riid

類型： REFIID

指定所要求介面的參考標識碼。這個值可以是IID_IAccessible或IID_IDispatch，但也可以IID_IUnknown或對象預期支援之任何介面的 IID。

[out] ppvObject

類型： void**

接收指定介面位址的指標變數位址。

類型： STDAPI

如果成功，則傳回 S_OK。

如果未成功，則傳回下列其中一個或另一個標準 COM 錯誤碼。

傳回碼	Description
E_INVALIDARG	引數無效。
E_NOINTERFACE	不支援要求的介面。

用戶端會呼叫此函式來擷取物件的 IAccessible、 IDispatch、 IEnumVARIANT、 IUnknown 或其他支援的介面指標位址。

如同其他 IAccessible 方法和函式，用戶端可能會因為用戶動作而收到 IAccessible 介面指標的錯誤。如需詳細資訊，請參閱接收 IAccessible 介面指標的錯誤。

用戶端會使用此函式來取得 Microsoft Office 2000 原生物件模型的存取權。原生物件模型提供客戶端有關 Microsoft Active Accessibility 未公開之 Office 應用程式檔或工作區的輔助功能資訊。

若要取得原生物件模型所支持類別的 IDispatch 介面指標，請在 dwObjectID 中指定OBJID_NATIVEOM。使用此物件識別碼時， hwnd 參數必須符合下列窗口類別類型。

請注意，上述視窗類別會對應至最內部的文檔視窗或窗格視窗。如需 Office 物件模型的詳細資訊，請參閱 Microsoft Office 2000/Visual Basic 程式設計人員指南。

需求	值
最低支援的用戶端	Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限傳統型應用程式]
目標平台	Windows
標頭	oleacc.h
程式庫	Oleacc.lib
Dll	Oleacc.dll
可轉散發套件	Windows NT 4.0 和更新版本和 Windows 95 上的 Active Accessibility 1.3 RDK