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

Recupera el identificador único asignado al elemento de la interfaz de usuario.

Sintaxis

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

Parámetros

[out, retval] runtimeId

Tipo: SAFEARRAY**

Recibe un puntero al identificador de tiempo de ejecución como una matriz de enteros.

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 solo se garantiza que sea único para la interfaz de usuario del escritorio en el que se generó. Los identificadores se pueden reutilizar con el tiempo.

El formato de los identificadores en tiempo de ejecución podría cambiar en el futuro. El identificador devuelto debe tratarse como un valor opaco y usarse solo para la comparación; por ejemplo, para determinar si un elemento de Microsoft Automatización de la interfaz de usuario está en la memoria caché.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 7, Windows Vista con SP2 y Platform Update para Windows Vista, Windows XP con SP3 y Platform Update para Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 R2, Windows Server 2008 con SP2 y Actualización de plataforma para Windows Server 2008, Windows Server 2003 con SP2 y Actualización de plataforma para Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado uiautomationclient.h (include UIAutomation.h)

Consulte también

Identificadores de propiedad del elemento Automation

Procedimientos recomendados para usar matrices seguras

CompareRuntimeIds

Conceptual

IUIAutomationElement

Referencia