Função UiaDisconnectProvider (uiautomationcoreapi.h)
Libera todas as referências que um provedor específico contém aos objetos do Microsoft Automação da Interface do Usuário.
Sintaxe
HRESULT UiaDisconnectProvider(
[in] IRawElementProviderSimple *pProvider
);
Parâmetros
[in] pProvider
Tipo: IRawElementProviderSimple*
O provedor a ser desconectado.
Retornar valor
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 provedor deve chamar essa função para limpo recursos Automação da Interface do Usuário associados a um elemento de interface do usuário que foi destruído. A DLL associada ao elemento de interface do usuário pode ser descarregada com segurança após o retorno da função.
Depois que essa função retornar, todas as solicitações de cliente associadas ao provedor desconectado receberão o código de erro UIA_E_ELEMENTNOTAVAILABLE .
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 UiaDisconnectProvider 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 mensagem específica está sendo tratada em resposta a uma chamada SendMessage .
Um aplicativo que chama UiaDisconnectProvider não deve responder a um reentrante 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
| Requisito | Valor |
|---|---|
| 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 |