Sobre restrições

Aplica-se a: Outlook 2013 | Outlook 2016

Uma restrição é uma maneira de limitar o número de linhas em um modo de exibição somente às linhas com valores para colunas que correspondam a critérios específicos. Há muitas oportunidades diferentes para usar restrições com tabelas. Os aplicativos cliente podem usar restrições, por exemplo, para filtrar uma tabela de conteúdo em busca de mensagens enviadas por uma determinada pessoa, para procurar linhas que não dão suporte a uma propriedade ou que definiram uma propriedade para um valor específico ou para procurar destinatários duplicados em uma mensagem.

Os métodos IMAPITable::Restrict e IMAPITable::FindRow são usados para definir restrições em uma tabela. Restringir aplica a restrição à tabela sem recuperar nenhuma linha. Para recuperar apenas as linhas que atendem à restrição, é necessária uma chamada subsequente para IMAPITable::QueryRows ou um método semelhante. FindRow aplica a restrição e recupera a primeira linha na tabela que corresponde aos critérios. FindRow aplica uma restrição temporária, que existe apenas durante a chamada, enquanto Restrict aplica uma restrição mais permanente.

Alguns clientes podem criar uma restrição usando colunas que não estão no conjunto de colunas atual. O suporte a essa restrição é opcional e os implementadores de tabela que dão suporte a ela agregam valor, especialmente para tabelas de conteúdo. Os implementadores de tabela que não dão suporte a ele podem retornar o valor MAPI_E_TOO_COMPLEX de uma chamada Restrict ou o valor MAPI_E_NOT_FOUND de uma chamada FindRow .

Os clientes devem estar cientes de que, mesmo que o provedor dê suporte a restrições em colunas que não estão no conjunto de colunas atual, eles obterão um melhor desempenho geral especificando as colunas que pretendem usar em suas restrições com IMAPITable::SetColumns.

Confira também

Tabelas MAPI