Exemplo de provedor de transporte

Aplica-se a: Outlook 2013 | Outlook 2016

Este exemplo usa arquivos e diretórios para transmitir e receber mensagens. Ele implementa e registra um pré-processador muito simples que anexa uma linha de texto a cada mensagem de saída. O exemplo ilustra como dividir o conteúdo da mensagem entre o Transport Neutral Encapsulation Format (TNEF) e o texto. Ele também suporta todas as opções de configuração (folhas de propriedades, assistentes e configuração programática) e opções de mensagem. Ele não oferece suporte às interfaces de transporte remoto.

Você pode baixar este exemplo dos exemplos de código MAPI (API de Mensagens do Outlook).

Propriedade Valor
Executável:
mrxp32.dll
Diretório do código-fonte:
SampleTransportProvider\MRXP
Idioma:
C++
Plataformas:
Visual Studio 2008 para compilação para Windows Vista, Windows Server 2008, Windows XP SP2 e Windows Server 2003 SP1

Recursos com suporte

Este exemplo dá suporte aos seguintes recursos:

  • Recursos básicos, como envio, recebimento e sondagem de novas mensagens.

  • Configuração interativa e programática.

  • A interface IMAPIStatus , exceto pela configuração de propriedade. Para obter mais informações, consulte a interface IMAPIStatus : IMAPIProp .

  • Segurança de thread.

  • Log de eventos para um arquivo de texto. O arquivo é limitado automaticamente a um tamanho especificado. Todas as sessões de transporte usam o mesmo arquivo.

Recursos sem suporte

Este exemplo não oferece suporte à detecção assíncrona de mensagens de entrada.

Para instalar o Provedor de Transporte de Exemplo

  1. Para baixar o Provedor de Transporte de Exemplo, consulte Download dos exemplos MAPI do Outlook.

  2. Localize a pasta onde você salvou os exemplos MAPI do Outlook. Clique com o botão direito do mouse na pasta zip do número> OutlookMAPISamples-version< e clique em Extrair tudo.

  3. Clique em Procurar, selecione o local onde deseja salvar a amostra e clique em Extrair.

  4. Execute o Visual Studio 2008.

  5. No Visual Studio 2008, clique em Arquivo, selecione Abrir e clique em Projeto/Solução.

  6. Navegue até o local onde você salvou a amostra, clique em mrxp32.vcproj e em Abrir.

  7. No menu Compilar, clique em Gerenciador de Configurações.

  8. Na caixa de diálogo Gerenciador de Configurações, vá para a linha mrxp32 e, na coluna Configuração, selecione Versão e clique em Fechar.

  9. On the Build menu, click Build Solution.

  10. Na caixa de diálogo Salvar Arquivo Como , clique em Salvar.

  11. Na pasta em que você salvou a amostra, clique com o botão direito do mouse no arquivo de instalação e clique em Executar como administrador.

  12. Na caixa de diálogo Controle de Conta de Usuário, clique em Continuar.

    Observação

    install.bat copia o .dll para a pasta de instalação padrão do Microsoft Office, C:\Program Files\Microsoft Office\Office12. Se você instalou os produtos do Office em um local diferente, clique com o botão direito do mouse eminstall.bat e clique em Editar. O arquivo é aberto no Bloco de notas. Substitua o caminho de instalação padrão pelo caminho de instalação usado no seu computador.

Para configurar o Provedor de Transporte no Outlook

  1. No menu Ferramentas do Outlook, clique em Configurações da Conta.

  2. Na caixa de diálogo Configurações da Conta, na guia Email, clique em Novo.

  3. Em Escolher Serviço de Email, clique em Outro, selecione Transporte de Exemplo MRXP e clique em Avançar.

  4. Na caixa de diálogo Configuração de Transporte MRXP , digite um Nome de Exibição do Usuário.

  5. Em Caminho para a Caixa de Entrada (Compartilhamento UNC), insira um caminho para a pasta. Esse também pode ser um caminho para uma pasta local.

    Importante

    Esse caminho deve existir.

  6. Clique em OK.

  7. Na caixa de diálogo Adicionar Conta de Email, clique em OK. Clique em Concluir e em Fechar.

  8. Para começar a usar a conta MRXP, saia e reinicie o Outlook.

Para usar o Exemplo de Provedor de Transporte para enviar uma mensagem no Outlook

  1. No menu Arquivo , clique em Novo e em Email.

  2. Na caixa Para, digite o nome do destinatário usando o formato [MRXP:<ADDRESS]>. O endereço é o compartilhamento UNC ou o caminho da pasta local para a caixa de entrada do destinatário.

    Observação

    Se houver dois-pontos ou barras invertidas no endereço, você deverá inserir uma barra invertida antes de cada dois-pontos ou barra invertida. Por exemplo, para enviar um email para [MRXP:C:\Mail\myDir], você deve digitar [MRXP:C\:\\Mail\\myDir].

    Importante

    O endereço do destinatário deve existir.

  3. Clique em Conta e em Transporte de Exemplo MRXP.

  4. Digite sua mensagem e clique em Enviar. A mensagem é enviada usando o provedor de transporte MRXP.

Para usar o Exemplo de Provedor de Transporte para receber uma mensagem no Outlook

  1. No menu Arquivo , clique em Novo e em Email.

  2. Digite sua mensagem.

  3. Clique no Botão Microsoft Office, em Salvar como e em Salvar como para salvar o arquivo na pasta da caixa de entrada especificada durante a configuração.

  4. Na caixa de diálogo Salvar como , navegue até o compartilhamento UNC ou pasta local que você definiu como sua caixa de entrada.

  5. No menu suspenso Salvar como tipo , clique em Formato de Mensagem do Outlook.

  6. Digite um nome para o arquivo e clique em Salvar.

  7. O arquivo é salvo na pasta compartilhada. O provedor de transporte MRXP entrega a mensagem na sua caixa de entrada no Outlook.