Adicionando a funcionalidade do Microsoft Agent ao seu aplicativo

[O Microsoft Agent foi preterido a partir do Windows 7 e pode não estar disponível em versões subsequentes do Windows.]

Para acessar as interfaces de servidor do Microsoft Agent, o Agent já deve estar instalado no sistema de destino. Não há suporte para instalação diferente do arquivo executável de autoinstalação do Agente, como a tentativa de copiar e registrar arquivos de componentes do Agente. Isso garante uma instalação consistente e completa. Observe que o arquivo de autoinstalação do Microsoft Agent não será instalado no Microsoft Windows 2000 e sistemas operacionais posteriores porque essas versões do sistema operacional já incluem sua própria versão do Agente.

Para instalar com êxito o Agent em um sistema de destino com um sistema operacional Microsoft Windows anterior, você também deve garantir que o sistema de destino tenha uma versão recente do tempo de execução do Microsoft Visual C++ (Msvcrt.dll), da ferramenta de registro da Microsoft (Regsvr32.dll) e dlls Microsoft COM. A maneira mais fácil de garantir que os componentes necessários estejam no sistema de destino é exigir que o Microsoft Internet Explorer 3.02 ou posterior esteja instalado. Como alternativa, você pode instalar os dois primeiros componentes que estão disponíveis como parte do Microsoft Visual C++. As dlls COM necessárias podem ser instaladas como parte da atualização do Microsoft DCOM, disponível no site da Microsoft. Você pode encontrar mais informações e informações de licenciamento para esses componentes no site da Microsoft.

Os componentes de linguagem do agente podem ser instalados da mesma maneira. Da mesma forma, você pode usar essa técnica para instalar o formato ACS dos caracteres da Microsoft disponíveis para distribuição no site do Microsoft Agent. Os arquivos de caracteres são instalados automaticamente no subdiretório Microsoft Agent \Chars.

Como os componentes do Microsoft Agent são projetados como componentes do sistema operacional, o Agent não pode ser desinstalado. Da mesma forma, quando o Agent já estiver instalado como parte do sistema operacional Windows, o gabinete de autoinstalação do Agent pode não ser instalado.

Uma vez instalado, para chamar as interfaces do Agente, crie uma instância do servidor e solicite um ponteiro para uma interface específica que o servidor suporta usando a convenção COM padrão. Em particular, a biblioteca COM fornece uma função de API, CoCreateInstance, que cria uma instância do objeto e retorna um ponteiro para a interface solicitada do objeto. Solicite um ponteiro para o IAgent ou interface IAgentEx em sua chamada CoCreateInstance ou em uma chamada subsequente para QueryInterface.

O código a seguir ilustra isso em C/C++.

hRes = CoCreateInstance(CLSID_AgentServer,
                     NULL,
                     CLSCTX_SERVER,
                     IID_IAgentEx,
                     (LPVOID *)&pAgentEx);

Se o servidor do Microsoft Agent estiver em execução, essa função se conectará ao servidor; caso contrário, ele inicia o servidor.

Observe que as interfaces de servidor do Microsoft Agent geralmente incluem interfaces estendidas que incluem um sufixo "Ex". Essas interfaces são derivadas e, portanto, incluem todas as funcionalidades de suas contrapartes não-Ex. Caso deseje utilizar algum dos recursos avançados, use as interfaces Ex.

As funções que recebem ponteiros para BSTRs alocam memória usando SysAllocString. É responsabilidade do chamador liberar essa memória usando SysFreeString.