Interfaces duplas: IAccessible e IDispatch

Os desenvolvedores de servidor devem fornecer a interface COM (Component Object Model) padrão de IDispatch para seus objetos acessíveis. A interface IDispatch permite que aplicativos cliente escritos no Microsoft Visual Basic e em vários idiomas de script usem os métodos e propriedades expostos por IAccessible. Como um objeto acessível fornece acesso a um objeto indiretamente por meio de IDispatch::Invoke ou diretamente com IAccessible, diz-se que ele tem uma interface dupla.

Quando os clientes C/C++ recebem de volta um ponteiro de interface IDispatch, os clientes podem chamar QueryInterface para tentar converter o ponteiro da interface IDispatch em um ponteiro de interfaceIAccessible. Para chamar os métodos IAccessible indiretamente, os clientes C/C++ chamam IDispatch::Invoke. Para melhorar o desempenho, chame os métodos de IAccessible para usar o objeto diretamente.

Para obter uma lista das IDs de expedição (DISPIDs) que IDispatch usa para identificar os métodos e propriedadesIAccessible, consulte Apêndice C: IAccessible DISPIDs.

Nota

Na versão 2.0 e posterior da Acessibilidade Ativa da Microsoft, os servidores não precisam implementar totalmente os métodos de de IDispatch, mas podem simplesmente retornar E_NOTIMPL depois de inicializar quaisquer parâmetros externos, conforme mostrado no exemplo a seguir.

 

HRESULT STDMETHODCALLTYPE AccServer::GetTypeInfoCount(UINT* pctinfo)
{
    *pctinfo = 0;
    return E_NOTIMPL;
};