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

Confira também

Funções para provedores

UiaDisconnectAllProviders