Compartilhar via


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 do usuário para instalar formulários nas várias bibliotecas de formulários. Por causa disso, você terá que criar um aplicativo pequeno – 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 associada 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, se a instalação for para a biblioteca de formulários local na estação de trabalho do usuário. Se necessário, modifique o arquivo de configuração de formulário para refletir os caminhos atuais dos componentes. O arquivo de configuração de formulário pode conter caminhos relativos, nesse caso, essa etapa pode não ser necessária.

  5. Conclua as etapas de registro OLE apropriadas 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 ícone (.ico) e configuração (.cfg) do formulário no 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. Essa etapa é recomendada, mas não obrigatória.

Observação

Você pode simplificar a instalação em uma biblioteca de formulários local substituindo as etapas 1 e 2 por uma chamada para a função MAPIOpenLocalFormContainer .

Confira também

Desenvolvendo servidores de formulário MAPI