Função UiaGetUpdatedCache (uiautomationcoreapi.h)

Nota Essa função foi preterida. Em vez disso, os aplicativos cliente devem usar as interfaces COM (Component Object Model) do Microsoft Automação da Interface do Usuário.

 

Atualizações o cache de valores de propriedade e padrões de controle.

Sintaxe

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

Parâmetros

[in] hnode

Tipo: HUIANODE

O elemento para o qual as informações atualizadas estão sendo solicitadas.

[in] pRequest

Tipo: UiaCacheRequest*

O endereço de uma estrutura UiaCacheRequest que especifica as informações armazenadas em cache a serem atualizadas.

[in] normalizeState

Tipo: NormalizeState

Um valor do tipo enumerado NormalizeState que especifica o tipo de normalização.

[in] pNormalizeCondition

Tipo: UiaCondition*

O endereço de uma estrutura UiaCondition que especifica uma condição na qual as informações podem ser normalizadas, se normalizeState for NormalizeState_Custom.

[out] ppRequestedData

Tipo: SAFEARRAY**

O endereço de uma variável que recebe um ponteiro para um SAFEARRAY que contém os dados solicitados. Este parâmetro é passado não inicializado. Consulte Observações.

[out] ppTreeStructure

Tipo: BSTR*

Um ponteiro para a descrição da estrutura de árvore. Este parâmetro é passado não inicializado. Consulte Observações.

Valor retornado

Tipo: HRESULT

Retorna S_OK se tiver êxito ou um valor de erro caso contrário.

Comentários

A estrutura de árvore é descrita por uma cadeia de caracteres em que cada caractere é "p" ou ")". O primeiro caractere na cadeia de caracteres sempre representa o nó raiz. A cadeia de caracteres será NULL se nenhum elemento for retornado pela função .

Um "p" representa um nó (elemento Automação da Interface do Usuário). Quando um "p" segue diretamente o outro, o segundo nó é filho do primeiro. Um ")" representa um passo de volta para cima da árvore. Por exemplo, "pp)p" representa um nó seguido por dois nós filho que são irmãos um do outro. Em "pp))p", o último nó é um irmão do primeiro.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	uiautomationcoreapi.h
Biblioteca	Uiautomationcore.lib
DLL	Uiautomationcore.dll