Funzione UiaDisconnectProvider (uiautomationcoreapi.h)

Rilascia tutti i riferimenti che un determinato provider contiene agli oggetti Microsoft Automazione interfaccia utente.

Sintassi

HRESULT UiaDisconnectProvider(
  [in] IRawElementProviderSimple *pProvider
);

Parametri

[in] pProvider

Tipo: IRawElementProviderSimple*

Provider da disconnettere.

Valore restituito

Tipo: HRESULT

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

Commenti

Un provider deve chiamare questa funzione per pulire Automazione interfaccia utente risorse associate a un elemento dell'interfaccia utente eliminato. La DLL associata all'elemento dell'interfaccia utente può essere scaricata in modo sicuro dopo che la funzione restituisce.

Dopo che questa funzione restituisce, tutte le richieste client associate al provider disconnesso ricevono il codice di errore UIA_E_ELEMENTNOTAVAILABLE .

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 UiaDisconnectProvider 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 UiaDisconnectProvider 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

UiaDisconnectAllProviders