UiaGetUpdatedCache 函式 (uiautomationcoreapi.h)

注意 此函式已被取代。 用戶端應用程式應該改用 Microsoft 使用者介面自動化 元件物件模型 (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 結構的位址，如果 normalizeState是NormalizeState_Custom，則會指定可正規化資訊的條件。

[out] ppRequestedData

類型： SAFEARRAY**

接收 SAFEARRAY 指標的變數位址，其中包含要求的數據。 這個參數會以未初始化的狀態傳遞。 請參閱＜備註＞。

[out] ppTreeStructure

類型： BSTR*

樹狀結構描述的指標。 這個參數會以未初始化的狀態傳遞。 請參閱＜備註＞。

傳回值

類型： HRESULT

如果成功，則傳回S_OK否則傳回錯誤值。

備註

樹狀結構是由字串所描述，其中每個字元都是 「p」 或 「) 」。。 字串中的第一個字元一律代表根節點。 如果函式未傳回任何專案，則字串為 NULL 。

“p” 代表節點 (使用者介面自動化 元素) 。 當一個 「p」 直接遵循另一個時，第二個節點是第一個節點的子系。 “) ” 代表備份樹狀結構的步驟。 例如，“pp) p” 代表一個節點，後面接著兩個同層級的子節點。 在 「pp) ) p」 中，最後一個節點是第一個節點的同層級節點。

規格需求

需求	值
最低支援的用戶端	Windows XP [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限桌面應用程式]
目標平台	Windows
標頭	uiautomationcoreapi.h
程式庫	Uiautomationcore.lib
Dll	Uiautomationcore.dll