UiaFind 函式 (uiautomationcoreapi.h)

注意 此函式已被取代。 用戶端應用程式應該改用 Microsoft 使用者介面自動化 元件物件模型 (COM) 介面。

 

擷取符合搜尋準則的一或多個 使用者介面自動化 節點。

語法

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

規格需求

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