Restrições do Catálogo de Endereços
Aplica-se a: Outlook 2013 | Outlook 2016
Os provedores de catálogo de endereços são necessários para dar suporte a três tipos de restrições nas tabelas de conteúdo de seus contêineres:
Restrições de propriedade de nome ambíguo
Restrições de propriedade de chave de instância
Restrições de conteúdo de nome de exibição prefixado
Restrições de nome ambíguas são restrições de propriedade usando a propriedade PR_ANR (PidTagAnr) para corresponder nomes de destinatário com entradas em contêineres de catálogo de endereços. A restrição de propriedade PR_ANR é um tipo de pesquisa "melhor palpite" pela qual os provedores de catálogo de endereços podem escolher a propriedade correspondente que funciona melhor para seu contêiner. Por exemplo, um provedor de catálogo de endereços pode implementar a restrição PR_ANR combinando nomes de destinatário com a propriedade PR_ACCOUNT (PidTagAccount) de cada entrada de contêiner, enquanto outro provedor pode usar PR_DISPLAY_NAME (PidTagDisplayName).
O MAPI recomenda que as implementações da restrição de PR_ANR atinjam um equilíbrio entre o desempenho adequado e a satisfação do usuário. A satisfação do usuário pode ser comprometida quando um provedor de catálogo de endereços implementa a restrição de forma que poucas ou muitas correspondências sejam encontradas. Alguns provedores de catálogo de endereços dão suporte ao que é conhecido como um nome distinto ou comum que não é exibido em uma caixa de diálogo, mas pode corresponder a uma restrição de nome ambígua.
Uma implementação típica pode ser analisar o nome de exibição do destinatário em palavras, correspondendo a qualquer entrada que contenha todas as palavras. Atenção a detalhes como confidencialidade à posição de palavra, se palavras não condicionadas são correspondidas e a escolha dos caracteres separadores pode variar. Por exemplo, se o nome a ser resolvido for "Bill L", uma restrição típica de PR_ANR selecionará as seguintes entradas como correspondentes:
Billy Larson
Bill Lee
Bill Logan Jr.
Sam Bill Lee
Restrições de chave de instância ou restrições de propriedade PR_INSTANCE_KEYpidTagInstanceKey (PidTagInstanceKey) são usadas na implementação de caixas de lista usadas em aplicativos cliente para exibir tabelas MAPI. Algumas implementações da caixa de listagem permitem que os usuários façam várias seleções, rolem para cima ou para baixo e retornem ao primeiro item selecionado. Para implementar esse comportamento, os clientes chamam IMAPITable::FindRow, passando uma restrição de propriedade na propriedade PR_INSTANCE_KEY para o método. Os provedores de catálogo de endereços são necessários para dar suporte a essa restrição.
Outro recurso das caixas de lista usadas para exibição de tabela é a capacidade de posicionar o cursor com base em um conjunto de caracteres de prefixo. À medida que o usuário começa a digitar caracteres de prefixo, o cliente move o cursor para o primeiro item que começa com esses caracteres. Os clientes implementam esse recurso com uma restrição de conteúdo com base na propriedade PR_DISPLAY_NAME e no nível FL_PREFIX difuso.