Método IAccessibleEx::GetRuntimeId (uiautomationcore.h)
Recupera el identificador en tiempo de ejecución de este elemento.
Sintaxis
HRESULT GetRuntimeId(
[out] SAFEARRAY **pRetVal
);
Parámetros
[out] pRetVal
Tipo: SAFEARRAY**
Recibe un puntero al identificador en tiempo de ejecución.
Valor devuelto
Tipo: HRESULT
Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.
Comentarios
El identificador en tiempo de ejecución es una matriz definida por el proveedor de enteros, el primer elemento del cual debe ser UiaAppendRuntimeId. El identificador en tiempo de ejecución debe ser único dentro de la ventana primaria.
El proxy de MSAA a UIA usa el identificador en tiempo de ejecución (junto con el identificador de ventana) para determinar si dos instancias de interfaz hacen referencia al mismo elemento subyacente. Si no se implementa IAccessibleEx::GetRuntimeId , el proxy realiza comparaciones de campo por campo en los dos objetos IAccessible para determinar si son equivalentes, lo que es menos eficaz.
Requisitos
| Cliente mínimo compatible | Windows 7, Windows Vista con SP2 y Actualización de plataforma para Windows Vista, Windows XP con SP3 y Actualización de plataforma para Windows Vista [aplicaciones de escritorio | Aplicaciones para UWP] |
| Servidor mínimo compatible | Windows Server 2008 R2, Windows Server 2008 con SP2 y Platform Update para Windows Server 2008, Windows Server 2003 con SP2 y Actualización de plataforma para Windows Server 2008 [aplicaciones de escritorio | Aplicaciones para UWP] |
| Plataforma de destino | Windows |
| Encabezado | uiautomationcore.h (include UIAutomation.h) |
Consulte también
Procedimientos recomendados para usar matrices seguras
Conceptual
Referencia