UiaReturnRawElementProvider-Funktion (uiautomationcoreapi.h)

Ruft eine Schnittstelle für den Benutzeroberflächenautomatisierung-Anbieter für ein Fenster ab.

Syntax

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

Parameter

[in] hwnd

Typ: HWND

Das Handle des Fensters, das das vom Anbieter bereitgestellte Element enthält.

[in] wParam

Typ: WPARAM

Das wParam-Argument der WM_GETOBJECT Nachricht.

[in] lParam

Typ: LPARAM

Das lParam-Argument der WM_GETOBJECT Nachricht.

[in] el

Typ: IRawElementProviderSimple*

Der Benutzeroberflächenautomatisierung Anbieter.

Rückgabewert

Typ: LRESULT

Der Schlüssel für den Clientprozess zum Herstellen einer Verbindung mit dem Serverprozess über Benutzeroberflächenautomatisierung.

Diese Funktion gibt null zurück, wenn sie verwendet wird, um Benutzeroberflächenautomatisierung zu benachrichtigen, dass sie sicher ist, die Ereigniszuordnung des Ausgelösten Anbieters zu entfernen. Weitere Informationen finden Sie in den Hinweisen.

Hinweise

Diese Funktion wird von einem Steuerelement aufgerufen, wenn es die WM_GETOBJECT-Nachricht empfängt, um Benutzeroberflächenautomatisierung mit dem Benutzeroberflächenautomatisierung Anbieter für das Steuerelement bereitzustellen. Das Steuerelement sollte die Parameter wParam und lParam an die UiaReturnRawElementProvider-Funktion übergeben, ohne sie zuerst zu filtern, da das Filtern Probleme mit Microsoft Active Accessibility-Clients verursachen kann. Die Fensterprozedur des Steuerelements sollte das Ergebnis des Aufrufs von UiaReturnRawElementProvider zurückgeben.

Wenn Microsoft Active Accessibility-Clients Ereignisse lauschen, die von einem Benutzeroberflächenautomatisierung Anbieter ausgelöst werden, verwaltet Benutzeroberflächenautomatisierung eine Zuordnung der Anbieter, die Ereignisse ausgelöst haben. Wenn die Microsoft Active Accessibility-Clients weitere Informationen anfordern, verwendet Benutzeroberflächenautomatisierung die Karte, um die Anforderungen an die entsprechenden Anbieter weiterzuleiten. Wenn ein Fenster, das zuvor Anbieter zurückgegeben hat, zerstört wurde, sollten Sie Benutzeroberflächenautomatisierung benachrichtigen, indem Sie die Funktion UiaReturnRawElementProvider wie folgt aufrufen: UiaReturnRawElementProvider(hwnd, 0, 0, NULL). Dieser Aufruf teilt Benutzeroberflächenautomatisierung mit, dass er alle Karteneinträge, die auf das angegebene Fenster verweisen, sicher entfernen kann. Dieser Aufruf kann Arbeitsspeicher sparen, da er Verweise auf die Anbieter freigibt, die von der Ausgelösten Ereigniszuordnung gespeichert werden. Die Funktion gibt null zurück, wenn sie mit diesen speziellen Parametern aufgerufen wird. Microsoft empfiehlt, diesen Aufruf über den WM_DESTROY Nachrichtenhandler des Fensters auszuführen, das die Benutzeroberflächenautomatisierung-Anbieter zurückgibt.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [Desktop-Apps | UWP-Apps]
Zielplattform	Windows
Kopfzeile	uiautomationcoreapi.h
Bibliothek	Uiautomationcore.lib
DLL	Uiautomationcore.dll