uiaFind 函数 (uiautomationcoreapi.h)

注意 此函数已弃用。 客户端应用程序应改用 Microsoft UI 自动化 组件对象模型 (COM) 接口。
 
检索与搜索条件匹配的一个或多个UI 自动化节点。

语法

HRESULT UiaFind(
  [in]  HUIANODE        hnode,
  [in]  UiaFindParams   *pParams,
  [in]  UiaCacheRequest *pRequest,
  [out] SAFEARRAY       **ppRequestedData,
  [out] SAFEARRAY       **ppOffsets,
  [out] SAFEARRAY       **ppTreeStructures
);

参数

[in] hnode

类型: HUIANODE

要用作搜索起点的节点。

[in] pParams

类型: UiaFindParams*

包含搜索参数的 UiaFindParams 结构的地址。

[in] pRequest

类型: UiaCacheRequest*

UiaCacheRequest 结构的地址,该结构指定要缓存的信息。

[out] ppRequestedData

类型: SAFEARRAY**

变量的地址,该变量接收指向包含所请求数据的 SAFEARRAY 的 指针。 此参数未经初始化即被传递。 请参阅“备注”。

[out] ppOffsets

类型: SAFEARRAY**

变量的地址,该变量接收指向 SAFEARRAY 的指针,该指针包含元素子树开始位置的请求数据数组的索引。 此参数未经初始化即被传递。

[out] ppTreeStructures

类型: SAFEARRAY**

变量的地址,该变量接收指向包含树结构说明的 SAFEARRAY 的指针。 此参数未经初始化即被传递。 请参阅“备注”。

返回值

类型: HRESULT

如果成功,则返回S_OK,否则返回错误值。

注解

树结构由字符串描述,其中每个字符都是“p”或“) ”。 字符串中的第一个字符始终表示根节点。 如果函数未返回任何元素,则字符串为 NULL

“p”表示节点 (UI 自动化 元素) 。 当一个“p”直接跟在另一个节点之后时,第二个节点是第一个节点的子节点。 “) ”表示对树的备份步骤。 例如,“pp) p”表示一个节点,后跟两个彼此同级节点的子节点。 在“pp) ) p”中,最后一个节点是第一个节点的同级节点。

要求

要求
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 uiautomationcoreapi.h
Library Uiautomationcore.lib
DLL Uiautomationcore.dll