Sobre Notificações de Tabela
Aplica-se a: Outlook 2013 | Outlook 2016
Os clientes geralmente dependem de notificações de tabela para saber de alterações em objetos em vez de se registrarem para receber notificações diretamente dos objetos. As alterações típicas que fazem com que as notificações sejam enviadas incluem a adição, exclusão ou modificação de uma linha e qualquer erro crítico. Quando as notificações chegam, os clientes podem determinar se devem fazer outra chamada para recarregar a tabela.
Como as notificações de tabela são assíncronas, há alguns problemas que podem tornar o tratamento de notificações menos que simples:
Os dados passados na estrutura de TABLE_NOTIFICATION podem não representar o estado mais atual da tabela. Por exemplo, um cliente pode fazer uma alteração em uma mensagem e decidir excluí-la. O provedor do repositório de mensagens que implementa a tabela de conteúdo que incluiu a mensagem envia duas notificações: um evento TABLE_ROW_MODIFIED seguido de um evento TABLE_ROW_DELETED. Dependendo de como o provedor do repositório de mensagens vezes notificações, o cliente pode receber a notificação TABLE_ROW_MODIFIED após a exclusão da linha.
O conjunto de colunas incluído com uma notificação pode ser diferente do conjunto de colunas atual da tabela. O MAPI exige que o conjunto de colunas de notificação corresponda ao conjunto de colunas que estava em vigor no momento em que a notificação foi gerada. Como é possível que um cliente chame IMAPITable::SetColumns para alterar o conjunto de colunas a qualquer momento , inclusive após uma notificação, os dois conjuntos de colunas podem não ser sincronizados.
As notificações de tabela são enviadas apenas para linhas que fazem parte do modo de exibição. Ou seja, se uma linha for excluída do modo de exibição devido a uma restrição ou porque a tabela estiver em um estado de colapso, nenhuma notificação será enviada se essa linha for alterada. Além disso, não são enviadas notificações para informar um cliente sobre uma alteração no estado da categoria.
Os clientes devem estar cientes de que nem todas as tabelas dão suporte à notificação TABLE_SORT_DONE e devem estar preparadas para lidar com essa condição:
Forçando a classificação a ser síncrona.
Recarregando as linhas da tabela quando IMAPITable::SortTable retornar.