Função UiaDisconnectAllProviders (uiautomationcoreapi.h)

Libera todos os recursos da Automação da Interface do Usuário da Microsoft mantidos por todos os provedores associados ao processo de chamada.

Sintaxe

HRESULT UiaDisconnectAllProviders();

Valor retornado

Tipo: HRESULT

Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Um aplicativo de provedor deve usar essa função para liberar recursos de Automação da Interface do Usuário antes de desligar.

Essa função não pode ser chamada em resposta a uma chamada para a função SendMessage . Um aplicativo não pode fazer chamadas COM (Component Object Model) de saída em resposta a uma chamada para SendMessage e liberar um provedor normalmente é uma chamada COM de saída. A função UiaDisconnectAllProviders retornará RPC_E_CANTCALLOUT_ININPUTSYNCCALL se a função for chamada em resposta a uma chamada sendMessage . Você pode usar a função InSendMessageEx para determinar se uma determinada mensagem está sendo tratada em resposta a uma chamada SendMessage .

Um aplicativo que chama UiaDisconnectAllProviders não deve responder a um novo participante WM_GETOBJECT mensagem retornando um ponteiro para o provedor que ele está tentando desconectar. Se o aplicativo tentar desconectar um provedor, mas chamar a função UiaReturnRawElementProvider com esse mesmo provedor durante a tentativa de desconexão, o provedor poderá não estar totalmente desconectado.

Requisitos

Cliente mínimo com suporte	Windows 8 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2012 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	uiautomationcoreapi.h
Biblioteca	Uiautomationcore.lib
DLL	Uiautomationcore.dll

Confira também

Funções para provedores

UiaDisconnectProvider