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

Article
03/06/2024

Récupère l’identificateur unique attribué à l’élément d’interface utilisateur.

Syntaxe

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

Paramètres

[out, retval] runtimeId

Type : SAFEARRAY**

Reçoit un pointeur vers l’ID d’exécution en tant que tableau d’entiers.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

L’identificateur est garanti uniquement pour être unique à l’interface utilisateur du bureau sur lequel il a été généré. Les identificateurs peuvent être réutilisés au fil du temps.

Le format des identificateurs d’exécution peut changer à l’avenir. L’identificateur retourné doit être traité comme une valeur opaque et utilisé uniquement à des fins de comparaison ; par exemple, pour déterminer si un élément Microsoft UI Automation se trouve dans le cache.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7, Windows Vista avec SP2 et Platform Update pour Windows Vista, Windows XP avec SP3 et Platform Update pour Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 R2, Windows Server 2008 avec SP2 et Mise à jour de plateforme pour Windows Server 2008, Windows Server 2003 avec SP2 et Mise à jour de plateforme pour Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	uiautomationclient.h (incluez UIAutomation.h)