ITableData : IUnknown
Aplica-se a: Outlook 2013 | Outlook 2016
Fornece métodos de utilitário para trabalhar com tabelas. O MAPI fornece objetos ou objetos de dados de tabela que implementam iTableData para ajudar os provedores de serviços a executar a manutenção da tabela. Para obter um objeto de dados de tabela, os provedores de serviços chamam a função CreateTable .
| Propriedade | Valor |
|---|---|
| Arquivo de cabeçalho: |
Mapiutil.h |
| Exposto por: |
Objetos de dados de tabela |
| Implementado por: |
MAPI |
| Chamado por: |
Provedores de serviços |
| Identificador de interface: |
IID_IMAPITableData |
| Tipo de ponteiro: |
LPTABLEDATA |
Vtable order
| Member | Descrição |
|---|---|
|
HrGetView |
Cria uma exibição de tabela, retornando um ponteiro para uma implementação IMAPITable . |
|
HrModifyRow |
Insere uma nova linha de tabela, possivelmente substituindo uma linha existente. |
|
HrDeleteRow |
Exclui uma linha de tabela. |
|
HrQueryRow |
Recupera uma linha de tabela. |
|
HrEnumRow |
Recupera uma linha com base em sua posição na tabela. |
|
HrNotify |
Envia uma notificação para uma linha de tabela. |
|
HrInsertRow |
Insere uma linha de tabela. |
|
HrModifyRows |
Insere várias linhas de tabela, possivelmente substituindo linhas existentes. |
|
HrDeleteRows |
Exclui várias linhas de tabela. |
Comentários
A implementação MAPI do ITableData funciona com tabelas mantendo todos os dados e quaisquer restrições associadas na memória, tornando-os inadequados para uso com tabelas muito grandes. Não há suporte para restrições grandes e operações complexas, como categorização.
Objetos de dados de tabela identificam linhas usando uma coluna de índice, uma propriedade que tem a garantia de ter um valor exclusivo para cada linha. A maioria dos provedores de serviços usa a propriedade PR_INSTANCE_KEY (PidTagInstanceKey) como a coluna de índice. As propriedades que têm vários valores não podem ser usadas como uma coluna de índice.
Objetos de dados de tabela geram uma única notificação, independentemente do número de linhas afetadas por uma alteração ou exclusão. Se uma linha de destino em uma operação não existir, uma linha será adicionada.