IUIAutomation::ElementFromHandleBuildCache method

Retrieves a UI Automation element for the specified window, prefetches the requested properties and control patterns, and stores the prefetched items in the cache.

Syntax

HRESULT ElementFromHandleBuildCache(
  UIA_HWND                  hwnd,
  IUIAutomationCacheRequest *cacheRequest,
  IUIAutomationElement      **element
);

Parameters

hwnd

Type: UIA_HWND

The window handle.

cacheRequest

Type: IUIAutomationCacheRequest*

A pointer to the cache request, which specifies the properties and control patterns to store in the cache.

element

Type: IUIAutomationElement**

Receives a pointer to the element.

Return Value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Requirements

   
Windows version Windows 7, Windows Vista with SP2 and Platform Update for Windows Vista, Windows XP with SP3 and Platform Update for Windows Vista [desktop apps only] Windows Server 2008 R2, Windows Server 2008 with SP2 and Platform Update for Windows Server 2008, Windows Server 2003 with SP2 and Platform Update for Windows Server 2008 [desktop apps only]
Target Platform Windows
Header uiautomationclient.h (include UIAutomation.h)

See Also

IUIAutomation

IUIAutomation::ElementFromHandle