Propriedade Canônica PidTagMessageRecipients
Aplica-se a: Outlook 2013 | Outlook 2016
Contém uma tabela de restrições que pode ser aplicada a uma tabela de conteúdo para localizar todas as mensagens que contêm subobjetos de destinatário que atendem às restrições.
| Propriedade | Valor |
|---|---|
| Propriedades associadas: |
PR_MESSAGE_RECIPIENTS |
| Identificador: |
0x0E12 |
| Tipo de dados: |
PT_OBJECT |
| Área: |
Envio de mensagens gerais |
Comentários
Essa propriedade pode ser excluída em operações IMAPIProp::CopyTo ou incluída nas operações IMAPIProp::CopyProps . Como uma propriedade do tipo PT_OBJECT, ela não pode ser recuperada com êxito pelo método IMAPIProp::GetProps . Seu conteúdo deve ser acessado pelo método IMAPIProp::OpenProperty , solicitando o identificador de interface IID_IMAPITable . Os provedores de serviços devem denunciá-lo ao método IMAPIProp::GetPropList se ele estiver definido, mas poderá, opcionalmente, denunciá-lo ou não se ele não estiver definido.
Para recuperar o conteúdo da tabela, um aplicativo cliente deve chamar o método IMessage::GetRecipientTable .
Essa propriedade pode ser usada para restrição de subobjeto especificando-a na estrutura SSubRestriction . Isso permite que um cliente limite a exibição de um contêiner a mensagens com destinatários atendendo aos critérios fornecidos. Uma mensagem se qualifica para exibição se pelo menos uma linha em sua tabela de destinatário, ou seja, um destinatário satisfaz a restrição de subobjeto.
Nota O uso de resultados de restrição de subobjeto é o equivalente a uma chamada IMAPISession::OpenEntry em cada mensagem na tabela. Dependendo do aplicativo cliente e do número de mensagens a serem pesquisadas, ele pode afetar o desempenho.
A propriedade PR_MESSAGE_ATTACHMENTS (PidTagMessageAttachments) e essa propriedade são semelhantes em uso. Várias propriedades MAPI fornecem acesso a tabelas:
| Propriedade | Table |
|---|---|
| PR_CONTAINER_CONTENTS (PidTagContainerContents) |
Tabela de conteúdo |
| PR_CONTAINER_HIERARCHY (PidTagContainerHierarchy) |
Tabela hierarquia |
| PR_FOLDER_ASSOCIATED_CONTENTS (PidTagFolderAssociatedContents) |
Tabela de conteúdo associada |
| PR_MESSAGE_ATTACHMENTS (PidTagMessageAttachments) |
Tabela anexo |
| PR_MESSAGE_RECIPIENTS |
Tabela do destinatário |
Recursos relacionados
Especificações de protocolo
Fornece referências às especificações de protocolo Exchange Server relacionadas.
Manipula a ordem e o fluxo para transferências de dados entre um cliente e um servidor.
Converte entre objetos IETF RFC2445, RFC2446 e RFC2447, e objetos de compromisso e reunião.
Habilita o tratamento de listas de permissões/blocos e a determinação de mensagens de email de lixo eletrônico.
Codifica e decodifica objetos de mensagem e anexo a uma representação de fluxo eficiente.
Arquivos de cabeçalho
Mapidefs.h
Fornece definições de tipo de dados.
Mapitags.h
Contém definições de propriedades listadas como nomes alternativos.