Funzione UiaReturnRawElementProvider (uiautomationcoreapi.h)

Ottiene un'interfaccia al provider di Automazione interfaccia utente per una finestra.

Sintassi

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

Parametri

[in] hwnd

Tipo: HWND

Handle della finestra contenente l'elemento servito dal provider.

[in] wParam

Tipo: WPARAM

Argomento wParam del messaggio di WM_GETOBJECT .

[in] lParam

Tipo: LPARAM

Argomento lParam del messaggio di WM_GETOBJECT .

[in] el

Tipo: IRawElementProviderSimple*

Provider di Automazione interfaccia utente.

Valore restituito

Tipo: LRESULT

Chiave per il processo client per connettersi al processo del server tramite Automazione interfaccia utente.

Questa funzione restituisce zero quando viene usata per notificare Automazione interfaccia utente che è sicuro rimuovere la mappa eventi generata dal provider. Per altre informazioni, vedere la sezione Osservazioni.

Commenti

Questa funzione viene chiamata da un controllo quando riceve il messaggio di WM_GETOBJECT, per fornire Automazione interfaccia utente con il provider di Automazione interfaccia utente per il controllo. Il controllo deve passare prima i parametri wParam e lParam alla funzione UiaReturnRawElementProvider senza filtrarli prima, perché il filtro può causare problemi con i client di Accessibilità attiva Microsoft. La procedura della finestra del controllo deve restituire il risultato della chiamata di UiaReturnRawElementProvider.

Quando i client di Accessibilità attiva Microsoft sono in ascolto degli eventi generati da un provider di Automazione interfaccia utente, Automazione interfaccia utente gestisce una mappa dei provider che hanno generato eventi. Quando i client di Accessibilità Attiva Microsoft richiedono ulteriori informazioni, Automazione interfaccia utente usa la mappa per instradare le richieste ai provider appropriati. Quando una finestra restituita in precedenza è stata eliminata, è necessario inviare una notifica Automazione interfaccia utente chiamando la funzione UiaReturnRawElementProvider come indicato di seguito: UiaReturnRawElementProvider(hwnd, 0, 0, NULL). Questa chiamata indica Automazione interfaccia utente che può rimuovere in modo sicuro tutte le voci della mappa che fanno riferimento alla finestra specificata. Questa chiamata può salvare la memoria perché rilascia riferimenti ai provider mantenuti dalla mappa eventi generata. La funzione restituisce zero quando viene chiamata con questi parametri speciali. Microsoft consiglia di effettuare questa chiamata dal gestore di messaggi WM_DESTROY della finestra che restituisce i provider di Automazione interfaccia utente.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [app desktop | App UWP]
Server minimo supportato	Windows Server 2003 [app desktop | App UWP]
Piattaforma di destinazione	Windows
Intestazione	uiautomationcoreapi.h
Libreria	Uiautomationcore.lib
DLL	Uiautomationcore.dll