UiaReturnRawElementProvider, fonction (uiautomationcoreapi.h)

Obtient une interface vers le fournisseur UI Automation pour une fenêtre.

Syntaxe

LRESULT UiaReturnRawElementProvider(
  [in] HWND                      hwnd,
  [in] WPARAM                    wParam,
  [in] LPARAM                    lParam,
  [in] IRawElementProviderSimple *el
);

Paramètres

[in] hwnd

Type : HWND

Handle de la fenêtre contenant l’élément pris en charge par le fournisseur.

[in] wParam

Type : WPARAM

Argument wParam du message WM_GETOBJECT .

[in] lParam

Type : LPARAM

Argument lParam du message WM_GETOBJECT .

[in] el

Type : IRawElementProviderSimple*

Fournisseur UI Automation.

Valeur retournée

Type : LRESULT

Clé permettant au processus client de se connecter au processus serveur via UI Automation.

Cette fonction retourne zéro lorsqu’elle est utilisée pour notifier UI Automation qu’il est sûr de supprimer le mappage d’événements déclenchés du fournisseur. Pour plus d'informations, consultez la section Notes.

Remarques

Cette fonction est appelée par un contrôle lorsqu’il reçoit le message WM_GETOBJECT, pour fournir UI Automation avec le fournisseur de UI Automation pour le contrôle. Le contrôle doit passer les paramètres wParam et lParam à la fonction UiaReturnRawElementProvider sans les filtrer d’abord, car le filtrage peut entraîner des problèmes avec les clients Microsoft Active Accessibility. La procédure de fenêtre du contrôle doit retourner le résultat de l’appel de UiaReturnRawElementProvider.

Lorsque les clients Microsoft Active Accessibility écoutent les événements déclenchés par un fournisseur de UI Automation, UI Automation conserve une carte des fournisseurs qui ont déclenché des événements. Lorsque les clients Microsoft Active Accessibility demandent des informations supplémentaires, UI Automation utilise la carte pour acheminer les demandes vers les fournisseurs appropriés. Lorsqu’une fenêtre qui a précédemment retourné des fournisseurs a été détruite, vous devez informer UI Automation en appelant la fonction UiaReturnRawElementProvider comme suit : UiaReturnRawElementProvider(hwnd, 0, 0, NULL). Cet appel indique à UI Automation qu’il peut supprimer en toute sécurité toutes les entrées de carte qui font référence à la fenêtre spécifiée. Cet appel peut économiser de la mémoire, car il libère les références aux fournisseurs détenus par le mappage d’événements déclenchés. La fonction retourne zéro lorsqu’elle est appelée avec ces paramètres spéciaux. Microsoft recommande d’effectuer cet appel à partir du gestionnaire de messages WM_DESTROY de la fenêtre qui retourne les fournisseurs UI Automation.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau | applications UWP]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau | applications UWP]
Plateforme cible	Windows
En-tête	uiautomationcoreapi.h
Bibliothèque	Uiautomationcore.lib
DLL	Uiautomationcore.dll