Tabelas de destinatário
Aplica-se a: Outlook 2013 | Outlook 2016
A tabela do destinatário contém informações sobre todos os destinatários de uma mensagem. Os provedores do repositório de mensagens implementam tabelas de destinatário e os aplicativos cliente as usam. Os clientes acessam uma tabela de destinatário fazendo uma chamada para o método IMessage::GetRecipientTable ou se o provedor do repositório de mensagens dá suporte a ela, para o método IMAPIProp::OpenProperty . Os clientes acessam tabelas de destinatário com OpenProperty especificando PR_MESSAGE_RECIPIENTS (PidTagMessageRecipients) para a marca de propriedade e IID_IMAPITable para o identificador de interface. As alterações em uma tabela de destinatário podem ser feitas chamando o método IMessage::ModifiRecipients .
As tabelas do destinatário têm um conjunto de colunas diferente, dependendo se a mensagem foi enviada. As seguintes propriedades compõem o conjunto de colunas necessário em tabelas de destinatários:
PR_DISPLAY_NAME (PidTagDisplayName)
PR_RECIPIENT_TYPE (PidTagRecipientType)
PR_ROWID (PidTagRowid)
As propriedades opcionais são:
PR_DISPLAY_TYPE (PidTagDisplayType)
PR_ENTRYID (PidTagEntryId)
PR_SPOOLER_STATUS (PidTagSpoolerStatus)
PR_OBJECT_TYPE (PidTagObjectType)
As mensagens enviadas devem incluir essas propriedades adicionais no conjunto de colunas necessário:
PR_ADDRTYPE (PidTagAddressType)
PR_RESPONSIBILITY (PidTagResponsibility)
Dependendo da implementação de um provedor, colunas adicionais, como PR_SENDER_NAME (PidTagSenderName) e ENTRYID, podem estar na tabela.
Qualquer provedor de armazenamento de mensagens que dê suporte à transmissão de mensagens — conforme indicado pelo bit STORE_SUBMIT_OK que está sendo definido na propriedade PR_STORE_SUPPORT_MASK (PidTagStoreSupportMask) do provedor – deve oferecer suporte para um determinado conjunto de restrições em uma implementação de tabela de destinatário. As restrições de propriedade E, OR, existem e estão entre os tipos de restrições que devem estar disponíveis para os usuários da tabela de destinatários. Somente os operadores iguais e não iguais precisam ter suporte na restrição de propriedade. Essas restrições devem funcionar com as seguintes propriedades:
PR_ADDRTYPE
PR_EMAIL_ADDRESS (PidTagEmailAddress)
PR_RECIPIENT_TYPE
PR_RESPONSIBILITY
PR_SPOOLER_STATUS