Partager via


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

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)

Voir aussi

ID de propriété d’élément Automation

Meilleures pratiques pour l’utilisation de tableaux sécurisés

CompareRuntimeIds

Conceptuel

IUIAutomationElement

Référence