Instalando um formulário em uma biblioteca

Aplica-se a: Outlook 2013 | Outlook 2016

O gerenciador de formulários MAPI padrão fornecido com o SDK do Windows não fornece uma interface de usuário para instalar formulários nas várias bibliotecas de formulários. Por isso, você terá que criar um pequeno aplicativo — ou um conjunto detalhado de instruções — que os usuários possam usar para instalar o formulário.

Se você implementar um aplicativo de instalação, a série de ações que ele deve executar para instalar um formulário na tabela de conteúdo associado de uma pasta será a seguinte:

1. Chame a função MAPIOpenFormMgr para abrir o gerenciador de formulários.

2. Use o método IMAPIFormMgr::OpenFormContainer ou IMAPIFormMgr::SelectFormContainer para selecionar e abrir o contêiner de destino para o formulário.

3. Use a função IMAPIFormContainer::InstallForm para instalar o formulário.

   As etapas 4 a 6 são para instalação em uma biblioteca de formulários local:

4. Copie todos os arquivos para o local apropriado no disco local, caso a instalação seja na biblioteca de formulários local na estação de trabalho do usuário. Se necessário, modifique o arquivo de configuração do formulário para refletir os caminhos atuais dos componentes. O arquivo de configuração do formulário pode conter caminhos relativos, caso em que esta etapa pode não ser necessária.

5. Conclua as etapas apropriadas do registro OLE para associar o tipo de mensagem ao servidor de formulário que está sendo instalado.

6. Se o formulário foi instalado na biblioteca de formulários local, copie os arquivos de ícone (.ico) e configuração (.cfg) do formulário para o diretório %WINDOWS%\FORMS\CONFIGS para que o formulário possa ser restaurado automaticamente caso a biblioteca de formulários seja corrompida ou excluída. Esta etapa é recomendada, mas não obrigatória.

Confira também

Desenvolvendo servidores de formulário MAPI