UiaHostProviderFromHwnd-Funktion (uiautomationcoreapi.h)

  • Artikel

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

Weitere Informationen

Funktionen für Anbieter