UiaDisconnectAllProviders-Funktion (uiautomationcoreapi.h)
Gibt alle Microsoft-Benutzeroberflächenautomatisierungsressourcen frei, die von allen Anbietern verwaltet werden, die dem Aufrufprozess zugeordnet sind.
Syntax
HRESULT UiaDisconnectAllProviders();
Rückgabewert
Typ: HRESULT
Wenn diese Funktion erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.
Hinweise
Eine Anbieteranwendung sollte diese Funktion verwenden, um Benutzeroberflächenautomatisierungsressourcen freizugeben, bevor sie heruntergefahren wird.
Diese Funktion kann nicht als Reaktion auf einen Aufruf der SendMessage-Funktion aufgerufen werden. Eine Anwendung kann als Reaktion auf einen Aufruf von SendMessage keine ausgehenden COM-Aufrufe (Component Object Model) durchführen, und das Freigeben eines Anbieters ist in der Regel ein ausgehender COM-Aufruf. Die Funktion UiaDisconnectAllProviders 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 behandelt wird.
Eine Anwendung, die UiaDisconnectAllProviders aufruft , sollte nicht auf eine Erneuteinstiegsnachricht WM_GETOBJECT reagieren, indem sie einen Zeiger auf den Anbieter zurückgibt, den sie trennen möchte. Wenn die Anwendung versucht, die Verbindung mit einem Anbieter zu trennen, aber dann die UiaReturnRawElementProvider-Funktion beim gleichen Anbieter während des Verbindungsversuchs aufruft, ist der Anbieter möglicherweise nicht vollständig getrennt.
Anforderungen
| 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 |