Visão geral das propriedades da mensagem
Aplica-se a: Outlook 2013 | Outlook 2016
O MAPI divide as propriedades da mensagem em três tipos:
Propriedades do conteúdo da mensagem.
Propriedades de transmissão ou envelope de mensagens.
Propriedades do destinatário da mensagem.
As propriedades do conteúdo da mensagem descrevem o texto de uma mensagem. Cada classe de mensagem tem seu próprio conjunto de propriedades de conteúdo. MAPI define propriedades de conteúdo para mensagens de observação e relatório; cabe aos clientes e aos provedores do repositório de mensagens que lidam com essas classes de mensagens definir as propriedades adequadamente para suas implementações. PR_BODY (PidTagBody) e PR_RTF_COMPRESSED (PidTagRtfCompressed) são exemplos de propriedades de conteúdo para mensagens de observação. PR_BODY contém o conteúdo não formatado de uma nota, enquanto PR_RTF_COMPRESSED contém a versão compactada do conteúdo formatado de uma nota. Para obter mais informações sobre intervalos de identificador de propriedade, consulte Intervalos de Identificador de Propriedade.
Para novas classes de mensagem, os clientes podem definir propriedades específicas do conteúdo de uma das duas maneiras:
Usando identificadores de propriedade no intervalo de propriedades de conteúdo da classe de mensagem personalizada: 0x6800 por meio de 0x7BFF.
Usando propriedades nomeadas que têm identificadores que caem no 0x8000 por meio do intervalo de 0xFFFE.
O intervalo de identificador para propriedades de conteúdo da classe de mensagem personalizada está disponível para qualquer cliente que crie uma classe de mensagem personalizada. Portanto, um identificador de propriedade nesse intervalo pode ser usado para várias classes de mensagem. Os usuários de propriedades nesse intervalo não podem fazer suposições quanto ao comportamento das propriedades.
Para propriedades nomeadas, os clientes criam um nome que especifica um conjunto de propriedades e uma cadeia de caracteres ou um valor numérico para cada nova propriedade. Em seguida, os clientes associam a propriedade a um identificador no intervalo de propriedades nomeado. Os usuários de propriedades nomeadas acessam-nas por nome ou identificador por meio dos métodos IMAPIProp::GetIDsFromNames e IMAPIProp::GetNamesFromIDs .
As propriedades do envelope fornecem informações usadas para transmitir uma mensagem de um destinatário para outro. Assim como acontece com as propriedades do conteúdo da mensagem, é possível que clientes ou provedores de serviços definam suas próprias propriedades de envelope para complementar as que o MAPI define. Clientes e provedores de transporte definem as propriedades do envelope que o MAPI define com base na definição que o MAPI fornece. Os provedores de transporte que implementam recursos especiais podem definir suas próprias propriedades de envelope para expor esses recursos aos clientes. O MAPI define de lado um intervalo de identificadores de propriedade que podem ser usados para essas propriedades especiais definidas pelo provedor. Os provedores de transporte normalmente implementam uma página de propriedade especial para exibir essas propriedades e permitir que os clientes as alterem. PR_SUBJECT (PidTagSubject) e PR_MESSAGE_CLASS (PidTagMessageClass) são exemplos de propriedades de envelope. Para obter mais informações, consulte Intervalos de Identificador de Propriedades.
As propriedades do destinatário descrevem o destino de uma mensagem enviada. Um destinatário pode ser um usuário de mensagens, uma lista de distribuição ou um computador. As propriedades do destinatário são definidas por MAPI e definidas por provedores de serviços. Algumas propriedades do destinatário têm suporte por provedores de catálogo de endereços para seus objetos de lista de distribuição e usuário de mensagens; outras propriedades do destinatário têm suporte para clientes, provedores de repositório de mensagens ou provedores de transporte. Por exemplo, todos os destinatários exigem um endereço e um tipo de endereço; estas são propriedades mantidas por um provedor de catálogo de endereços quando o destinatário é armazenado em um de seus contêineres. Os destinatários também têm um tipo, PR_RECIPIENT_TYPE (PidTagRecipientType), que identifica um destinatário como um destinatário primário, cópia de carbono ou cópia de carbono cego.
Muitas propriedades de mensagem são opcionais, o que significa que os clientes não podem esperar que eles estejam disponíveis ou definidos como valores válidos. Algumas propriedades de mensagem são necessárias, mas disponíveis somente quando uma mensagem está em um estado específico. Por exemplo, uma mensagem recém-criada não é necessária para ter um identificador de entrada até que a mensagem tenha sido salva, e não é necessário ter uma classe de mensagem até que a mensagem esteja pronta para ser enviada. Os clientes devem sempre marcar os resultados de suas chamadas IMAPIProp::GetProps e IMAPIProp::OpenProperty e ter valores padrão prontos como backup caso uma propriedade solicitada não esteja disponível.
A maioria das propriedades de mensagem definidas por provedores de serviços são somente leitura para clientes.