Anexos MAPI

Aplica-se a: Outlook 2013 | Outlook 2016

Alguns provedores de repositório de mensagens permitem que os clientes associem informações adicionadas na forma de arquivos, objetos OLE, mensagens ou dados binários a mensagens. Essas informações adicionadas são chamadas de anexo de uma mensagem. Como os anexos são criados, mantidos e acessados somente 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 um número de anexo. Esse número identifica exclusivamente o anexo em 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ão válidos apenas enquanto a mensagem estiver aberta e armazenada na propriedade PR_ATTACH_NUM (PidTagAttachNumber).

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

• Chamando IMessage::GetAttachmentTable. Para obter mais informações, consulte IMessage::GetAttachmentTable.

• Chamando IMAPIProp::OpenProperty. Para obter mais informações, consulte IMAPIProp::OpenProperty.

Espera-se que os provedores de repositório de mensagens deem suporte a essas duas abordagens. A abordagem OpenProperty requer 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 de 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 podem ser usados:

• Com IMAPIProp::OpenProperty para acessar uma tabela de anexos ou destinatários.

• 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 anexos.