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

Weitere Informationen

Funktionen für Anbieter

UiaDisconnectProvider