Compartilhar via

Anexos MAPI

  • Artigo

Aplica-se a: Outlook 2013 | Outlook 2016

Alguns provedores do repositório de mensagens permitem que os clientes associem informações adicionais na forma de arquivos, objetos OLE, mensagens ou dados binários com mensagens. Essas informações adicionadas são chamadas de anexo de uma mensagem. Como os anexos são criados, mantidos e acessados apenas por meio de suas mensagens, eles são considerados subobjetos de mensagem. Em vez de ter um identificador de entrada para acesso, os anexos têm um número sequencial conhecido como número de anexo. Esse número identifica exclusivamente o anexo dentro de sua mensagem, mas não necessariamente dentro do repositório de mensagens. Duas mensagens diferentes podem ter anexos diferentes com o mesmo número de anexo. Os números de anexo só são válidos desde que a mensagem esteja aberta e sejam armazenadas na propriedade PR_ATTACH_NUM (PidTagAttachNumber).

Para acessar informações de resumo sobre todos os anexos de uma mensagem, os clientes recuperam sua tabela de anexos. A tabela de anexo inclui informações que os clientes podem usar para acessar um anexo diretamente, como o número de anexo e a chave de registro. Os clientes podem recuperar uma tabela de anexo por:

Espera-se que os provedores do repositório de mensagens dêem suporte a ambas as abordagens. A abordagem OpenProperty exige que o chamador especifique IID_IMAPITable como o identificador de interface e PR_MESSAGE_ATTACHMENTS (PidTagMessageAttachments) como a marca de propriedade. PR_MESSAGE_ATTACHMENTS é uma propriedade de objeto de tabela que representa a tabela de anexo de uma mensagem. Os provedores do repositório de mensagens são necessários para definir PR_MESSAGE_ATTACHMENTS para cada mensagem e incluí-la na matriz de marcas de propriedade retornadas do método IMAPIProp::GetPropList . Para obter mais informações, consulte IMAPIProp::GetPropList.

PR_MESSAGE_ATTACHMENTS pode ser usado:

  • Com IMAPIProp::OpenProperty para acessar um anexo ou uma tabela de destinatário.

  • Com IMAPIProp::CopyTo ou IMAPIProp::CopyProps para excluir ou incluir anexos ao copiar. Para obter mais informações, consulte IMAPIProp::CopyTo e IMAPIProp::CopyProps.

  • Em uma restrição de subobjeto para indicar que a restrição filho deve ser aplicada a anexos.

Para obter mais informações, consulte Tabelas de Anexo.