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
라이브러리	Uiautomationcore.lib
DLL	Uiautomationcore.dll