Pastas de Pesquisa MAPI
Aplica-se a: Outlook 2013 | Outlook 2016
Uma pasta de resultados de pesquisa contém links para mensagens em pastas genéricas em vez das mensagens reais. Os clientes criam uma pasta de resultados de pesquisa chamando o método IMAPIFolder::CreateFolder com FOLDER_SEARCH como o parâmetro ulFolderType . Os clientes preenchem uma pasta de resultados de pesquisa configurando e aplicando critérios de pesquisa – regras que filtram mensagens com características específicas. Os critérios de pesquisa são configurados com o método IMAPIContainer::SetSearchCriteria . Os clientes criam uma ou mais estruturas de SRestriction para representar os critérios de pesquisa a serem aplicados e passá-los para SetSearchCriteria. SetSearchCriteria também especifica uma lista de pastas que indicam o domínio de pesquisa e um conjunto de sinalizadores que controlam como a pesquisa é executada.
SetSearchCriteria identifica as mensagens que correspondem à restrição especificada. As mensagens selecionadas (as que atendem aos critérios) são exibidas como links na pasta resultados da pesquisa. Quando o cliente chama o método IMAPIContainer::GetContentsTable para acessar a tabela de conteúdo da pasta de resultados de pesquisa, as mensagens selecionadas são exibidas na tabela. Tabelas de conteúdo para pastas de resultados de pesquisa contêm as mesmas colunas que tabelas de conteúdo para pastas genéricas. No entanto, para pastas de resultados de pesquisa, a propriedade PR_PARENT_ENTRYID (PidTagParentEntryId) especifica o identificador de entrada da pasta em que reside a mensagem vinculada. As pastas de resultados de pesquisa não são consideradas pastas pai.
As pastas de resultados de pesquisa têm os seguintes limites:
A única maneira pela qual o conteúdo de uma pasta de resultados de pesquisa pode ser modificado é por meio de uma chamada para SetSearchCriteria. Para obter mais informações sobre a implementação do SetSearchCriteria, consulte Artigo da Base de Dados de Conhecimento 260322: Como pesquisar pastas com o Método SetSearchCriteria.
As mensagens não podem ser movidas ou copiadas em pastas de resultados de pesquisa.
As pastas de resultados de pesquisa não podem conter subpastas.
Os clientes não podem fazer de uma pasta de resultados de pesquisa o assunto de uma pesquisa.
No entanto, é possível modificar as propriedades de uma pasta de resultados de pesquisa e usá-la para excluir uma mensagem. Quando uma mensagem é excluída de uma pasta de resultados de pesquisa, ela é realmente excluída da pasta real. No entanto, a exclusão da pasta de resultados de pesquisa em si não tem impacto nas mensagens internas; eles permanecem em suas pastas genéricas.