Escolhendo uma classe de mensagem
Aplica-se a: Outlook 2013 | Outlook 2016
Conforme descrito em Classes de Mensagens MAPI, as classes de mensagem são importantes para estabelecer a relação entre tipos de mensagens personalizadas e, por extensão, entre os próprios servidores de formulário. Felizmente, escolher uma cadeia de caracteres de classe de mensagem é bastante simples. A cadeia de caracteres de classe de mensagem de uma classe de mensagem é uma cadeia de caracteres arbitrária, mas deve usar as seguintes convenções:
A cadeia de caracteres deve atender a todas as convenções descritas na documentação da propriedade PR_MESSAGE_CLASS (PidTagMessageClass). É importante ressaltar que a cadeia de caracteres deve ser composta inteiramente de caracteres ANSI e ter menos de 256 caracteres.
Se o servidor de formulário for derivado de um servidor de formulário existente ou for uma extensão de um servidor de formulário existente, sua cadeia de caracteres de classe de mensagem deverá ser formada adicionando um período e outra palavra à cadeia de caracteres de classe de mensagem do servidor de formulário em que seu formulário se baseia. Por exemplo, talvez você queira implementar um formulário para reagendar uma reunião e seu formulário é baseado em um formulário existente para agendar reuniões. Se a cadeia de caracteres de classe de agendamento de reunião for "IPM. Reunião", sua cadeia de caracteres de classe de mensagem pode ser "IPM. Meeting.Reschedule".
Se o formulário não for baseado em nenhum formulário existente, sua cadeia de caracteres de classe de mensagem ainda deverá começar com o prefixo "IPM" ou "IPC", dependendo se o formulário deve ser recebido por uma pessoa ou por outro aplicativo. "IPM" designa uma mensagem interpessoal que geralmente acaba na caixa de entrada de um usuário e "IPC" designa uma mensagem de comunicação entre processos que normalmente não é entregue na caixa de entrada de um usuário.
Se sua classe de mensagem tiver a intenção de ser legível pelo homem, a cadeia de caracteres da classe de mensagem deverá começar com "IPM". Uma classe de mensagem geralmente é considerada legível pelo homem se usar quaisquer propriedades que contenham dados de texto simples, HTML ou RTF (Rich Text Format). Se o formulário usar a propriedade PR_BODY (PidTagBody), ele certamente deverá usar uma cadeia de caracteres de classe de mensagem "IPM". Por exemplo, se você estiver implementando um formulário para pedidos de compra e sua organização exigir que as ordens de compra sejam aprovadas por um gerente, sua cadeia de caracteres de classe de mensagem poderá ser "IPM. Purchase_Order". Os formulários projetados para uso com pastas públicas ou aplicativos de pasta pública normalmente são considerados interpessoais porque são lidos por pessoas, embora não sejam realmente endereçados ao endereço de email de qualquer pessoa. O prefixo típico para classes de mensagens de pasta pública é "IPM.Post".
Se sua classe de mensagem tiver a intenção de ser recebida por outro aplicativo em vez de por uma pessoa, a cadeia de caracteres da classe de mensagem deverá começar com "IPC". Por exemplo, se você estiver implementando um formulário que permita que as pessoas assinem automaticamente as listas de email, sua cadeia de caracteres de classe de mensagem poderá ser "IPC. Assinar".
Sua cadeia de caracteres de classe de mensagem nunca deve terminar com um período.
A cadeia de caracteres de classe de mensagem deve ser colocada na seção [Descrição] do arquivo de configuração do formulário, na entrada MessageClass , semelhante à seguinte:
MessageClass=IPM.Meeting.Reschedule
Depois de escolher uma cadeia de caracteres de classe de mensagem apropriada, você deve gerar um identificador de classe para ela. Os identificadores de classe podem ser gerados com o comando Criar GUID incluído no Visual Studio. O identificador de classe deve ser colocado na entrada CLSID do arquivo de configuração de formulário, juntamente com a entrada MessageClass , semelhante à seguinte:
CLSID={88FFF551-B8C5-11ce-8DE0-00AA0060D242}
Seu identificador de classe certamente será diferente, é claro. Para obter mais informações, consulte Criando um arquivo de configuração de formulário.
Quando o formulário é instalado no computador de um usuário, o processo de instalação – seja um programa de instalação ou outra coisa – deve fazer uma entrada de registro na seção *HKEY_CLASSES_ROOT\CLSID* do registro para o identificador de classe. Essa entrada deve ser definida como a cadeia de caracteres da classe de mensagem. Por exemplo, você criaria uma entrada de registro semelhante à seguinte para o identificador de classe de exemplo acima:
HKEY_CLASSES_ROOT\CLSID\{88FFF551-B8C5-11ce-8DE0-00AA0060D242}="IPM.Meeting.Reschedule"
Para obter mais informações, consulte Instalando um formulário em uma biblioteca.