Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Aplica-se a: Outlook 2013 | Outlook 2016
O MAPI divide as propriedades da mensagem em três tipos:
Propriedades do conteúdo da mensagem.
Transmissão de mensagens ou propriedades de envelope.
Propriedades do destinatário da mensagem.
As propriedades de conteúdo da mensagem descrevem o texto de uma mensagem. Cada classe de mensagem tem seu próprio conjunto de propriedades de conteúdo. O MAPI define as propriedades de conteúdo para mensagens de anotação e relatório; Cabe aos clientes e provedores de repositório de mensagens que manipulam essas classes de mensagens definir as propriedades apropriadamente para suas implementações. PR_BODY (PidTagBody) e PR_RTF_COMPRESSED (PidTagRtfCompressed) são exemplos de propriedades de conteúdo para mensagens de anotação. PR_BODY contém o conteúdo não formatado de uma anotação, enquanto PR_RTF_COMPRESSED contém a versão compactada do conteúdo formatado de uma anotação. Para obter mais informações sobre intervalos de identificadores de propriedade, consulte Intervalos de identificadores de propriedade.
Para novas classes de mensagem, os clientes podem definir propriedades específicas de conteúdo de duas maneiras:
Usando identificadores de propriedade no intervalo de propriedades de conteúdo de classe de mensagem personalizada: 0x6800 a 0x7BFF.
Usando propriedades nomeadas que têm identificadores que se enquadram no intervalo de 0x8000 a 0xFFFE.
O intervalo do identificador para propriedades de conteúdo de 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 mensagens. 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. Os clientes então associam a propriedade a um identificador no intervalo de propriedades nomeadas. Os usuários de propriedades nomeadas os acessam por nome ou identificador por meio dos métodos IMAPIProp::GetIDsFromNames e IMAPIProp::GetNamesFromIDs .
As propriedades do envelope fornecem informações que são usadas para transmitir uma mensagem de um destinatário para outro. Assim como acontece com as propriedades de conteúdo da mensagem, é possível que clientes ou provedores de serviços definam suas próprias propriedades de envelope para complementar aquelas definidas pelo MAPI. Clientes e provedores de transporte definem as propriedades do envelope que MAPI define com base na definição que 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 reserva 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 propriedades 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 identificadores de propriedade.
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 pelo MAPI e definidas pelos provedores de serviços. Algumas propriedades de destinatário são suportadas por provedores de catálogo de endereços para seus objetos de lista de distribuição e usuário de mensagens; Outras propriedades de destinatário têm suporte de 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; Essas 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, de cópia carbono ou de cópia oculta.
Muitas propriedades de mensagem são opcionais, o que significa que os clientes não podem esperar que elas estejam disponíveis ou definidas como valores válidos. Algumas propriedades da mensagem são necessárias, mas estão disponíveis somente quando uma mensagem está em um determinado estado. Por exemplo, uma mensagem recém-criada não precisa 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 pelos provedores de serviços são somente leitura para os clientes.