UiaHostProviderFromHwnd-Funktion (uiautomationcoreapi.h)
Ruft den Hostanbieter für ein Fenster ab.
Syntax
HRESULT UiaHostProviderFromHwnd(
[in] HWND hwnd,
[out] IRawElementProviderSimple **ppProvider
);
Parameter
[in] hwnd
Typ: HWND
Das Fenster, das das vom Anbieter bereitgestellte Element enthält.
[out] ppProvider
Typ: IRawElementProviderSimple**
Der Hostanbieter für das Fenster.
Rückgabewert
Typ: HRESULT
Wenn diese Funktion erfolgreich ist, gibt sie S_OK zurück. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.
Hinweise
Das von dieser Funktion abgerufene Objekt ist nur nützlich, um auf Aufrufe der IRawElementProviderSimple::get_HostRawElementProvider-Methode zu reagieren. Sie können das -Objekt nicht verwenden, um Ereignisse auszulösen, Eigenschaften bereitzustellen usw. Wenn Sie Ereignisse auslösen oder Eigenschaften bereitstellen müssen, müssen Sie ein Anbieterobjekt erstellen, das die IRawElementProviderSimple-Schnittstelle vollständig implementiert.
Beispiele
Im folgenden Beispiel wird der Hostanbieter für das Fenster zurückgegeben, in dem das steuerelement gehostet wird, das von diesem Anbieter bereitgestellt wird.
HRESULT STDMETHODCALLTYPE Provider::get_HostRawElementProvider(IRawElementProviderSimple** pRetVal)
{
return UiaHostProviderFromHwnd(controlHWnd, pRetVal);
}
Anforderungen
| 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 |