Escolher um conjunto de propriedades do formulário
Aplica-se a: Outlook 2013 | Outlook 2016
Ao implementar seu servidor de formulários, você precisa ter uma propriedade para cada pedaço de informação que sua classe de mensagem precisa. Essas propriedades podem ser propriedades MAPI predefinidas ou podem ser propriedades personalizadas que você define. Para obter mais informações sobre como trabalhar com propriedades, consulte Visão geral da propriedade MAPI.
Seu arquivo de configuração de formulário conterá uma lista de propriedades que o servidor de formulário expõe para aplicativos cliente usarem, mas essa não precisa ser a lista inteira de propriedades usadas pelo servidor de formulários. Os aplicativos cliente normalmente usam as propriedades expostas para permitir que os usuários classifiquem mensagens em uma pasta ou personalizem suas interfaces de alguma forma.
O MAPI tem um grande conjunto de propriedades predefinidas que são suficientes para a maioria dos aplicativos. No entanto, haverá momentos em que uma classe de mensagem personalizada precisa de uma propriedade que o MAPI não define. Você pode usar propriedades personalizadas para estender o conjunto predefinido de propriedades MAPI para quaisquer informações especiais que seu servidor de formulário precise dar suporte.
Você pode usar uma das seguintes maneiras para definir propriedades personalizadas:
Escolha um nome para a propriedade e use o método IMAPIProp::GetIDsFromNames para obter uma marca de propriedade para ela. A interface IMAPIProp por meio da qual você chama esse método vem do ponteiro IMessage que é passado para o servidor de formulários quando a mensagem é criada. Observe que o nome da propriedade deve ser uma cadeia de caracteres larga.
Defina uma marca de propriedade personalizada por conta própria. As marcas de propriedade personalizadas devem estar no intervalo 0x6800 até 0x7BFF. As propriedades nesse intervalo são específicas da classe de mensagem.
Para obter mais informações sobre como definir propriedades personalizadas, consulte Definindo novas propriedades MAPI.
Observação
Os servidores de formulário que têm um texto de mensagem geralmente usam a propriedade PR_RTF_COMPRESSED (PidTagRtfCompressed) para armazená-la. Se o servidor de formulário usar PR_RTF_COMPRESSED, ele também deverá garantir que a propriedade PR_BODY (PidTagBody) contenha uma versão somente texto do texto da mensagem, caso a mensagem resultante seja lida por um cliente que não dá suporte ao texto de mensagem RTF (Rich Text Format).