Función UiaDisconnectAllProviders (uiautomationcoreapi.h)

Libera todos los recursos de Automatización de la interfaz de usuario de Microsoft que mantienen todos los proveedores asociados al proceso de llamada.

Sintaxis

HRESULT UiaDisconnectAllProviders();

Valor devuelto

Tipo: HRESULT

Si esta función se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Una aplicación de proveedor debe usar esta función para liberar los recursos de Automatización de la interfaz de usuario antes de apagarse.

No se puede llamar a esta función en respuesta a una llamada a la función SendMessage . Una aplicación no puede realizar llamadas salientes al modelo de objetos componentes (COM) en respuesta a una llamada a SendMessage y liberar un proveedor suele ser una llamada COM saliente. La función UiaDisconnectAllProviders devuelve RPC_E_CANTCALLOUT_ININPUTSYNCCALL si se llama a la función en respuesta a una llamada a SendMessage . Puede usar la función InSendMessageEx para determinar si un mensaje determinado se controla en respuesta a una llamada sendMessage .

Una aplicación que llama a UiaDisconnectAllProviders no debe responder a un mensaje de WM_GETOBJECT entrante devolviendo un puntero al proveedor que está intentando desconectar. Si la aplicación intenta desconectar un proveedor, pero después llama a la función UiaReturnRawElementProvider con ese mismo proveedor durante el intento de desconexión, es posible que el proveedor no esté completamente desconectado.

Requisitos

Consulte también

Funciones para proveedores

UiaDisconnectProvider