uiaGetUpdatedCache 函数 (uiautomationcoreapi.h)

  • 项目
注意 此函数已弃用。 客户端应用程序应改用 Microsoft UI 自动化 组件对象模型 (COM) 接口。
 
汇报属性值和控件模式的缓存。

语法

HRESULT UiaGetUpdatedCache(
  [in]  HUIANODE        hnode,
  [in]  UiaCacheRequest *pRequest,
  [in]  NormalizeState  normalizeState,
  [in]  UiaCondition    *pNormalizeCondition,
  [out] SAFEARRAY       **ppRequestedData,
  [out] BSTR            *ppTreeStructure
);

参数

[in] hnode

类型： HUIANODE

正在请求更新信息的元素。

[in] pRequest

类型： UiaCacheRequest*

UiaCacheRequest 结构的地址，该结构指定要更新的缓存信息。

[in] normalizeState

类型： NormalizeState

NormalizeState 枚举类型的值，指定规范化的类型。

[in] pNormalizeCondition

类型： UiaCondition*

UiaCondition 结构的地址，该结构指定在 normalizeStateNormalizeState_Custom时可对其规范化信息的条件。

[out] ppRequestedData

类型： SAFEARRAY**

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

[out] ppTreeStructure

类型： BSTR*

指向树结构说明的指针。 此参数未经初始化即被传递。 请参阅“备注”。

返回值

类型： 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