Funzione UiaDisconnectAllProviders (uiautomationcoreapi.h)

Rilascia tutte le risorse di Microsoft Automazione interfaccia utente mantenute da tutti i provider associati al processo di chiamata.

Sintassi

HRESULT UiaDisconnectAllProviders();

Valore restituito

Tipo: HRESULT

Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Un'applicazione provider deve usare questa funzione per rilasciare Automazione interfaccia utente risorse prima di arrestare.

Questa funzione non può essere chiamata in risposta a una chiamata alla funzione SendMessage . Un'applicazione non può effettuare chiamate COM (Component Object Model) in uscita in risposta a una chiamata a SendMessage e il rilascio di un provider è in genere una chiamata COM in uscita. La funzione UiaDisconnectAllProviders restituisce RPC_E_CANTCALLOUT_ININPUTSYNCCALL se la funzione viene chiamata in risposta a una chiamata SendMessage . È possibile usare la funzione InSendMessageEx per determinare se un determinato messaggio viene gestito in risposta a una chiamata SendMessage .

Un'applicazione che chiama UiaDisconnectAllProviders non deve rispondere a un messaggio di nuovo partecipante WM_GETOBJECT restituendo un puntatore al provider che sta tentando di disconnettersi. Se l'applicazione tenta di disconnettere un provider, ma chiama la funzione UiaReturnRawElementProvider con lo stesso provider durante il tentativo di disconnessione, il provider potrebbe non essere completamente disconnesso.

Requisiti

Vedi anche

Funzioni per provider

UiaDisconnectProvider