UiaProviderFromIAccessible 函数 (uiautomationcoreapi.h)

基于指定的 Microsoft Active Accessibility 对象创建 Microsoft UI 自动化提供程序。

语法

HRESULT UiaProviderFromIAccessible(
  [in]  IAccessible               *pAccessible,
  [in]  long                      idChild,
  [in]  DWORD                     dwFlags,
  [out] IRawElementProviderSimple **ppProvider
);

参数

[in] pAccessible

类型： IAccessible*

指向 Microsoft Active Accessibility 对象的指针。

[in] idChild

类型： long

Microsoft Active Accessibility 对象的子 ID。

[in] dwFlags

类型：DWORD

以下值之一：

UIA_PFIA_DEFAULT

UIA_PFIA_UNWRAP_BRIDGE

[out] ppProvider

类型： IRawElementProviderSimple**

新的 UI 自动化提供程序。

返回值

类型： HRESULT

如果此函数成功，则返回 S_OK。 否则，将返回 HRESULT 错误代码。

注解

UI 自动化通过为 Microsoft Active Accessibility 提供程序提供代理（称为 MICROSOFT Active Accessibility 到 UI 自动化代理）来为它们提供向后兼容性。 当窗口通过返回 Microsoft Active Accessibility 提供程序响应 WM_GETOBJECT 消息时，会自动创建此代理。 需要手动创建 MICROSOFT Active Accessibility to UI Automation 代理时，请使用 UiaProviderFromIAccessible ;例如，在实现 IAccessibleEx 接口时。

某些属性（如 LabeledBy）必须表示为 UI 自动化提供程序。 IAccessibleEx 提供程序可以使用 UiaProviderFromIAccessible 包装 IAccessible 对象，以将其作为 LabeledBy 属性的值返回。

要求

最低受支持的客户端	Windows 8 [桌面应用 |UWP 应用]
最低受支持的服务器	Windows Server 2012 [桌面应用 |UWP 应用]
目标平台	Windows
标头	uiautomationcoreapi.h
Library	Uiautomationcore.lib
DLL	Uiautomationcore.dll

另请参阅

提供程序的函数

UiaIAccessibleFromProvider