Método IUIAutomation::P ollForPotentialSupportedProperties (uiautomationclient.h)

Artigo
03/03/2024

Recupera as propriedades que podem ter suporte em um elemento Automação da Interface do Usuário.

Sintaxe

HRESULT PollForPotentialSupportedProperties(
  [in]  IUIAutomationElement *pElement,
  [out] SAFEARRAY            **propertyIds,
  [out] SAFEARRAY            **propertyNames
);

Parâmetros

[in] pElement

Tipo: IUIAutomationElement*

O endereço do elemento Automação da Interface do Usuário a ser sondado.

[out] propertyIds

Tipo: SAFEARRAY(int)**

Recebe um ponteiro para uma matriz de identificadores de propriedade. Para obter uma lista de IDs de propriedade, consulte Identificadores de propriedade.

[out] propertyNames

Tipo: SAFEARRAY(BSTR)**

Recebe um ponteiro para uma matriz de nomes de propriedade.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Esse método destina-se apenas ao uso pelas ferramentas de Automação da Interface do Usuário da Microsoft que precisam verificar propriedades e padrões de controle. Ele não se destina a ser usado por clientes Automação da Interface do Usuário.

Não há nenhuma garantia de que o elemento dará suporte a qualquer propriedade específica quando solicitado posteriormente.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 7, Windows Vista com SP2 e Atualização de Plataforma para Windows Vista, Windows XP com SP3 e Atualização de Plataforma para Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 R2, Windows Server 2008 com SP2 e Atualização de Plataforma para Windows Server 2008, Windows Server 2003 com SP2 e Atualização de Plataforma para Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	uiautomationclient.h (inclua UIAutomation.h)