Compartilhar via


Método IAccessibleEx::GetRuntimeId (uiautomationcore.h)

Recupera o identificador de runtime desse elemento.

Sintaxe

HRESULT GetRuntimeId(
  [out] SAFEARRAY **pRetVal
);

Parâmetros

[out] pRetVal

Tipo: SAFEARRAY**

Recebe um ponteiro para o identificador de runtime.

Valor retornado

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 de runtime é uma matriz de inteiros definida pelo provedor, cujo primeiro item deve ser UiaAppendRuntimeId. O identificador de runtime deve ser exclusivo dentro da janela pai.

O Proxy MSAA-to-UIA usa o identificador de runtime (juntamente com o identificador de janela) para determinar se duas instâncias de interface se referem ao mesmo elemento subjacente. Se IAccessibleEx::GetRuntimeId não for implementado, o proxy executará comparações campo a campo nos dois objetos IAccessible para determinar se eles são equivalentes, o que é menos eficiente.

Requisitos

   
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 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2008 R2, Windows Server 2008 com SP2 e Platform Update para Windows Server 2008, Windows Server 2003 com SP2 e Platform Update para Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho uiautomationcore.h (inclua UIAutomation.h)

Confira também

Práticas recomendadas para usar matrizes seguras

Conceitual

IAccessibleEx

Referência