Sobre restrições
Aplica-se a: Outlook 2013 | Outlook 2016
Uma restrição é uma maneira de limitar o número de linhas em uma exibição apenas para aquelas linhas com valores para colunas que correspondem 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 para mensagens enviadas por uma determinada pessoa, para pesquisar linhas que não dão suporte a uma propriedade ou definiram uma propriedade como um valor específico ou 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 duração da chamada, enquanto Restrição 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 ela podem retornar o valor MAPI_E_TOO_COMPLEX de uma chamada Restrict ou do 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 não no conjunto de colunas atual, eles terão um melhor desempenho geral especificando as colunas que pretendem usar em suas restrições com IMAPITable::SetColumns.