Método IUIAutomationElement::GetRuntimeId (uiautomationclient.h)

Artigo
03/13/2024

Recupera o identificador exclusivo atribuído ao elemento de interface do usuário.

Sintaxe

HRESULT GetRuntimeId(
  [out, retval] SAFEARRAY **runtimeId
);

Parâmetros

[out, retval] runtimeId

Tipo: SAFEARRAY**

Recebe um ponteiro para a ID de runtime como uma matriz de inteiros.

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

O identificador só tem a garantia de ser exclusivo para a interface do usuário da área de trabalho na qual foi gerado. Os identificadores podem ser reutilizados ao longo do tempo.

O formato dos identificadores em tempo de execução pode mudar no futuro. O identificador retornado deve ser tratado como um valor opaco e usado apenas para comparação; por exemplo, para determinar se um elemento microsoft Automação da Interface do Usuário está no cache.

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)