Implementando tabelas de One-Off

Aplica-se a: Outlook 2013 | Outlook 2016

Seu provedor pode implementar uma ou mais tabelas pontuais. Uma tabela única é uma lista de resumo de modelos pontuais usados para criar destinatários, diretamente em um contêiner ou na lista de destinatários de uma mensagem de saída. Um modelo único é um formulário que os usuários empregam para inserir dados relevantes para um determinado tipo de endereço. Quando o usuário terminar de trabalhar com o modelo, seu provedor cria o novo destinatário e o adiciona à mensagem. Normalmente, cada modelo manipula um único tipo de endereço. No entanto, é possível que um modelo manipule vários tipos ou que vários modelos manipulem o mesmo tipo.

Seu provedor deve dar suporte ao método OpenEntry para cada modelo que ele inclui na tabela única. A implementação do OpenEntry deve recuperar uma tabela de exibição para o modelo. O MAPI usa a tabela de exibição para tornar o modelo visível para o usuário.

Embora a maioria das linhas em tabelas pontuais represente modelos, algumas das linhas podem ser usadas para categorizar ou agrupar modelos. Se uma linha em uma tabela única representa ou não um modelo é indicado pelo valor de sua coluna PR_SELECTABLE (PidTagSelectable). As linhas que representam modelos têm a coluna PR_SELECTABLE definida como TRUE; Linhas que não representam modelos o definem como FALSE.

O MAPI define três tipos de tabelas pontuais:

• Uma tabela única que reflete os modelos que um contêiner individual dá suporte

• Uma tabela única que reflete todos os modelos compatíveis com o provedor

• Uma tabela pontual que reflete todos os modelos que todos os provedores no suporte de perfil mais alguns que o MAPI dá suporte

Os dois primeiros tipos são implementados por provedores que dão suporte aos destinatários de criação, seja em uma mensagem ou em um contêiner. Seu provedor pode incluir o mesmo conjunto ou um conjunto diferente de modelos em suas tabelas pontuais. A main diferença entre os dois tipos é que a tabela do provedor deve incluir modelos para criar destinatários que podem ser usados em mensagens de saída e sua tabela de contêiner deve incluir modelos para criar destinatários a serem adicionados ao contêiner. Um contêiner só pode dar suporte a um conjunto restrito de modelos, mas a tabela única do provedor deve incluir todos os modelos compatíveis com o provedor.

O terceiro tipo de tabela única é implementado pelo MAPI; os provedores obtêm acesso a ele chamando IMAPISupport::GetOneOffTable. A tabela única MAPI é a união de todas as tabelas do provedor; ele inclui todos os modelos com suporte por cada provedor no perfil. Ele também inclui modelos com suporte por MAPI. Seu provedor pode usar essa tabela no lugar da tabela solicitada para um contêiner. No entanto, os modelos nesta tabela também podem ser usados para criar destinatários para mensagens de saída.