Conteúdo Tabelas

Aplica-se a: Outlook 2013 | Outlook 2016

Uma tabela de conteúdo contém informações sobre objetos em um contêiner MAPI. Os provedores de catálogo de endereços implementam tabelas de conteúdo para cada um de seus contêineres, e os provedores de repositório de mensagens e de transporte remoto implementam tabelas de conteúdo para suas pastas. A tabela de conteúdo de um contêiner de catálogo de endereços lista informações sobre seu usuário de mensagens e objetos de lista de distribuição, enquanto a tabela de conteúdo de uma pasta lista informações sobre suas mensagens. As tabelas de conteúdo são usadas principalmente por aplicativos cliente.

Há dois tipos de tabelas de conteúdo de pasta:

• As tabelas de conteúdo Standard contêm mensagens padrão — mensagens que podem ser transmitidas e tornadas visíveis para um usuário.

• As tabelas de conteúdo associado contêm informações ocultas e não transmissíveis criadas por um cliente para uma finalidade específica, como armazenar uma representação alternativa de uma mensagem padrão. As informações associadas são criadas passando o sinalizador MAPI_ASSOCIATED para a chamada IMAPIFolder::CreateMessage .

As tabelas de conteúdo da maioria dos contêineres do catálogo de endereços e muitas pastas não oferecem suporte à classificação categorizada.

Uma tabela de conteúdo pode ser acessada chamando:

• IMAPIContainer::GetContentsTable.

  • Ou -

• IMAPIProp::OpenProperty com PR_CONTAINER_CONTENTS (PidTagContainerContents) ou PR_FOLDER_ASSOCIATED_CONTENTS (PidTagFolderAssociatedContents) (somente pastas) especificado como a marca de propriedade e IID_IMAPITable como o identificador de interface.

Os provedores de repositório de mensagens e catálogo de endereços devem dar suporte a ambas as técnicas para recuperar propriedades da tabela. É inaceitável que os provedores deem suporte a apenas uma maneira de acessar essas tabelas porque os clientes esperam ter a escolha.

GetContentsTable aceita como entrada vários sinalizadores que especificam preferências. Quando definido, o sinalizador MAPI_ASSOCIATED recupera uma tabela de conteúdo associada. Como algumas pastas não dão suporte a conteúdo associado e não há como os clientes determinarem isso antecipadamente, GetContentsTable às vezes retorna a MAPI_E_NO_SUPPORT de erro quando uma tabela de conteúdo associado é solicitada.

O sinalizador MAPI_DEFERRED_ERRORS indica ao implementador da tabela que quaisquer erros encontrados durante a chamada não precisam ser relatados até algum momento posterior.

A chamada para IMAPIProp::OpenProperty envolve o acesso a uma tabela de conteúdo abrindo sua propriedade correspondente, PR_CONTAINER_CONTENTS para tabelas de conteúdo do catálogo de endereços e tabelas de conteúdo de pasta padrão e PR_FOLDER_ASSOCIATED_CONTENTS para tabelas de conteúdo associadas. Embora nenhuma dessas propriedades possa ser recuperada por meio do método IMAPIProp::GetProps de uma pasta ou contêiner, elas são incluídas na matriz de marca de propriedade retornada pelo método IMAPIProp::GetPropList .

PR_CONTAINER_CONTENTS também pode ser usado para incluir ou excluir uma tabela de conteúdo de uma operação de cópia. Se um cliente especificar PR_CONTAINER_CONTENTS no parâmetro lpExcludeProps para IMAPIProp::CopyTo em uma operação de cópia, a nova pasta ou contêiner não dará suporte à tabela de conteúdo da pasta ou contêiner original.

As tabelas de conteúdo da pasta e do contêiner do catálogo de endereços têm uma longa lista de colunas necessárias, colunas que os clientes podem esperar que estejam disponíveis depois de recuperarem a tabela de GetContentsTable ou OpenProperty. Os provedores podem adicionar a esse conjunto necessário, se necessário, e os clientes, por meio do método SetColumns , também podem solicitar modificações.

As colunas necessárias para cada um dos tipos de tabelas de conteúdo são:

O identificador de entrada disponível com cada linha pode ser um identificador de entrada de curto ou longo prazo, dependendo da implementação da tabela. Os identificadores de entrada de curto prazo geralmente são usados em situações em que o desempenho é um problema. Qualquer tipo de identificador de entrada pode ser usado para acessar o objeto correspondente.

As tabelas de conteúdo também têm um conjunto de colunas que são opcionais, mas comumente incluídas pelos provedores de serviços em suas implementações. Essas colunas opcionais são:

Os provedores do repositório de mensagens também devem incluir PR_PARENT_DISPLAY (PidTagParentDisplay) somente para pastas de resultados de pesquisa, conteúdo, tabelas.

As propriedades nomeadas podem ser adicionadas ao conjunto de colunas de uma tabela de conteúdo da pasta somente se todas as mensagens na pasta tiverem a mesma assinatura de mapeamento, ou seja, o mesmo mapeamento de nomes de propriedade para identificadores de propriedade. As tabelas de conteúdo da pasta devem dar suporte à adição de propriedades específicas da classe de mensagem ao conjunto de colunas, se derem suporte à criação de mensagens arbitrárias na pasta.

Os clientes podem salvar a ordem de classificação padrão para uma tabela de conteúdo da pasta chamando seu método IMAPIFolder::SaveContentsSort . Se o sinalizador de RECURSIVE_SORT for especificado na chamada, a ordem de classificação poderá ser feita para ser aplicada a todas as subpastas dentro da pasta.

Confira também

Tabelas MAPI