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

Récupère l’identificateur d’exécution de cet élément.

Syntaxe

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

Paramètres

[out] pRetVal

Type : SAFEARRAY**

Reçoit un pointeur vers l’identificateur du runtime.

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 du runtime est un tableau d’entiers défini par le fournisseur, dont le premier élément doit être UiaAppendRuntimeId. L’identificateur du runtime doit être unique dans la fenêtre parente.

Le proxy MSAA-UIA utilise l’identificateur d’exécution (ainsi que le handle de fenêtre) pour déterminer si deux instances d’interface font référence au même élément sous-jacent. Si IAccessibleEx::GetRuntimeId n’est pas implémenté, le proxy effectue des comparaisons champ par champ sur les deux objets IAccessible pour déterminer s’ils sont équivalents, ce qui est moins efficace.

Configuration requise

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

Voir aussi

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

Conceptuel

IAccessibleEx

Référence