UiaDisconnectProvider-Funktion (uiautomationcoreapi.h)

  • Artikel

Gibt alle Verweise frei, die ein bestimmter Anbieter auf Microsoft Benutzeroberflächenautomatisierung-Objekte enthält.

Syntax

HRESULT UiaDisconnectProvider(
  [in] IRawElementProviderSimple *pProvider
);

Parameter

[in] pProvider

Typ: IRawElementProviderSimple*

Der Anbieter, der getrennt werden soll.

Rückgabewert

Typ: HRESULT

Wenn diese Funktion erfolgreich ist, gibt sie S_OK zurück. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Ein Anbieter sollte diese Funktion aufrufen, um Benutzeroberflächenautomatisierung Ressourcen zu sauber, die einem zerstörten UI-Element zugeordnet sind. Die dem UI-Element zugeordnete DLL kann nach der Rückgabe der Funktion sicher entladen werden.

Nachdem diese Funktion zurückgegeben wurde, erhalten alle Clientanforderungen, die dem getrennten Anbieter zugeordnet sind, den UIA_E_ELEMENTNOTAVAILABLE Fehlercode.

Diese Funktion kann nicht als Reaktion auf einen Aufruf der SendMessage-Funktion aufgerufen werden. Eine Anwendung kann keine ausgehenden COM-Aufrufe (Component Object Model) als Reaktion auf einen Aufruf von SendMessage ausführen, und das Freigeben eines Anbieters ist in der Regel ein ausgehender COM-Aufruf. Die UiaDisconnectProvider-Funktion gibt RPC_E_CANTCALLOUT_ININPUTSYNCCALL zurück, wenn die Funktion als Reaktion auf einen SendMessage-Aufruf aufgerufen wird. Sie können die InSendMessageEx-Funktion verwenden, um zu bestimmen, ob eine bestimmte Nachricht als Reaktion auf einen SendMessage-Aufruf verarbeitet wird.

Eine Anwendung, die UiaDisconnectProvider aufruft, sollte nicht auf eine erneute Anmeldung WM_GETOBJECT Nachricht reagieren, indem sie einen Zeiger auf den Anbieter zurückgibt, der versucht, die Verbindung zu trennen. Wenn die Anwendung versucht, die Verbindung mit einem Anbieter zu trennen, dann aber die UiaReturnRawElementProvider-Funktion mit demselben Anbieter während des Verbindungsversuchs aufruft, wird der Anbieter möglicherweise nicht vollständig getrennt.

Anforderungen

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

Weitere Informationen

Funktionen für Anbieter

UiaDisconnectAllProviders