Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
A pesquisa :protocolo de aplicação é uma convenção extensível para chamar a aplicação de pesquisa no ambiente de trabalho no Windows Vista com Service Pack 1 (SP1) e versões posteriores. O protocolo foi criado no Windows Vista com SP1 para dar ao Windows uma maneira de determinar e chamar o aplicativo de pesquisa de área de trabalho padrão.
A sintaxe do protocolo fornece uma série de parâmetros úteis para executar pesquisas comuns na área de trabalho, como termos de pesquisa inseridos pelo usuário ou o local em que a pesquisa foi iniciada. Quando os utilizadores pesquisam a partir de um dos dois pontos de entrada de pesquisa disponíveis (o menu Iniciar ou o Explorador do Windows), o sistema operativo utiliza o protocolo de pesquisa para iniciar a aplicação de pesquisa de ambiente de trabalho predefinida. Ele faz isso adicionando os termos de pesquisa inseridos pelo usuário à sintaxe padrão do protocolo de pesquisa e passando essas informações para o aplicativo registrado como o aplicativo de pesquisa padrão.
Se nenhum outro aplicativo de pesquisa da área de trabalho estiver instalado, uma pesquisa inserida nesses pontos de entrada iniciará o Windows Search Explorer. No entanto, desenvolvedores de terceiros podem criar, instalar e registrar seus aplicativos para lidar com o protocolo de pesquisa e ser o aplicativo de pesquisa padrão. Esses aplicativos precisam suportar a sintaxe do protocolo de pesquisa e se registrar com o recurso Programas Padrão para garantir uma experiência sem problemas com o Windows.
Se desenvolveres uma aplicação que se destina a usar ou construir sobre uma aplicação de pesquisa de ambiente de trabalho específico, não deves depender exclusivamente do pesquisa: protocolo. Como muitas aplicações podem possuir o protocolo de pesquisa :, não há garantia de que a sua aplicação de pesquisa de desktop designada possa possuí-lo em determinado momento. Em vez disso, deve usar um protocolo de pesquisa privado especificado por essa aplicação de pesquisa direcionada para ambiente de trabalho. Isto significa que as aplicações de pesquisa de ambiente de trabalho, destinadas a servir de plataforma para aplicações de terceiros, devem suportar tanto o protocolo de pesquisa : como o seu próprio protocolo de pesquisa proprietário.
Observação
O protocolo search: não substitui o protocolo proprietário search-ms:. Os aplicativos ainda podem usar o protocolo search-ms: para iniciar o Window Search Explorer ou para consultar silenciosamente o indexador do Windows Search.
Este tópico aborda o seguinte:
- Sintaxe
- Windows Vista com SP1 uso da pesquisa: protocolo
- Exemplos
- Registrando o aplicativo que manipula o protocolo
- Tópicos relacionados
Sintaxe
O protocolo de pesquisa usa a seguinte sintaxe padrão codificada por URL:
search:parameter=value[¶meter=value]&
A sintaxe começa identificando o próprio protocolo (pesquisa:). Os pares parâmetro/valor são argumentos passados para o mecanismo de pesquisa, conforme descrito na tabela a seguir, que mostra todos os parâmetros possíveis para a sintaxe do protocolo de pesquisa.
| Parâmetro | Valor | Descrição |
|---|---|---|
| consulta | Texto codificado por URL | O texto da consulta inserido pelo usuário. |
| localdeentrada | Qualquer identificador de código de idioma válido (LCID) | O LCID que identifica o idioma de entrada para a consulta. |
| palavra-chave locale | Qualquer LCID válido | O LCID que identifica o idioma da versão internacional do Indexador. O padrão é 1033 (en-us). |
| migalha | Declaração AQS | Este argumento restringe o âmbito que está a ser pesquisado. No Windows Vista, o protocolo de pesquisa suporta AQS completo, bem como uma implementação especial para um argumento location. No sistema Windows XP, o protocolo de pesquisa também suporta o AQS completo, exceto para uma implementação especial de kind e store. |
| sintaxe | NQS, AQS (não diferencia maiúsculas de minúsculas) | A sintaxe de consulta a ser usada para pesquisar o índice: Sintaxe de Consulta Natural ou Sintaxe de Consulta Avançada (AQS). AQS é o padrão, sendo sempre considerado analisado e suportado. |
| empilhados por | Qualquer propriedade válida do sistema de propriedades | Uma propriedade que especifica a coluna segundo a qual os resultados são empilhados. |
| de subconsulta | Um caminho totalmente especificado para um arquivo de Pesquisa Salva (*.search-ms) | Os resultados da subconsulta são usados como a fonte para a consulta. Ou seja, os termos da consulta são pesquisados em relação aos resultados da subconsulta. |
| nome de exibição | Cadeia de caracteres codificada por URL | O nome da pesquisa atual. |
Windows Vista com SP1 no uso do protocolo de pesquisa
O Windows Vista com o SP1 tem vários pontos de entrada a partir dos quais chama o protocolo de pesquisa :. Esses pontos de entrada são descritos abaixo, bem como a sintaxe comum associada a cada um.
| Ponto de entrada do protocolo de pesquisa | Localização | Consulta iniciada |
|---|---|---|
| Pesquise em todos os lugares | Iniciar menu | search:query=<termo de pesquisa> |
| Pesquise em todos os lugares | Explorador do Windows | search:query=<Termo de pesquisa>&crumb=location:<LOCALIZAÇÃO> |
| Tecla do logótipo do Windows+F | Em qualquer lugar | pesquisar: |
| CTRL+F | Explorador do Windows | search:query=<Termo de pesquisa>&crumb=location:<LOCALIZAÇÃO> |
| F3 | Iniciar menu | pesquisar: |
| F3 | Explorador do Windows | search:query=<Termo de pesquisa>&crumb=location:<LOCALIZAÇÃO> |
Os pontos de entrada do protocolo de pesquisa do Windows Vista com SP1 não aproveitam todos os parâmetros possíveis no protocolo de pesquisa. Os aplicativos que se preocupam apenas em lidar com chamadas de protocolo de pesquisa do Windows Vista com SP1 podem usar a tabela a seguir como um guia para o mínimo que precisam implementar.
| Parâmetro | É utilizado pelo Windows? | Como o Windows Vista com SP1 o usa ao chamar a pesquisa: |
|---|---|---|
| consulta | Sim | O texto da consulta inserido pelo usuário. |
| migalha | Sim |
migalha usa o argumento location para especificar de onde veio a consulta. |
| de subconsulta | Sim | Os resultados do argumento Subconsulta são usados como o escopo dos itens a serem pesquisados. Isso normalmente seria usado se um usuário estivesse usando um arquivo .search-ms para pesquisar e, em seguida, chamasse o aplicativo de pesquisa de área de trabalho padrão de dentro dessa pesquisa. |
| inputlocale | Não | Não utilizado atualmente. |
| palavra-chave local | Não | Não utilizado atualmente. |
| sintaxe | Não | Não utilizado atualmente. |
| empilhado por | Não | Não utilizado atualmente. |
| nome de exibição | Não | Não utilizado atualmente. |
Exemplos
Se um utilizador digitar "Microsoft" no menu Iniciar e clicar em Pesquisar em todos os lugares, a chamada de protocolo de pesquisa resultante será feita.
search:query=microsoft&
Se um usuário digitar "Seattle" no Windows Explorer dentro de C:\MyFolder e, em seguida, clicar em Pesquisar em todos os lugares, a seguinte chamada será feita, usando caracteres de escape para ':' e '\':
search:query=seattle&crumb=location:C%3A%5CMyFolder
Registrando o aplicativo que lida com o protocolo
Como várias aplicações podem disputar o protocolo de pesquisa, deve registar a sua aplicação com o recurso Programas Predefinidos durante a instalação, para permitir que o utilizador configure o predefinido de forma mais fácil. Além dos procedimentos de instalação normalmente praticados no Windows XP, um aplicativo baseado no Windows Vista deve se registrar com o recurso Programas Padrão para que o aplicativo e os usuários possam configurar padrões sem problemas.
Depois de instalar os arquivos binários necessários no computador do usuário, sua rotina de instalação deve concluir estas tarefas gerais:
- Escreva ProgIDs para HKEY_LOCAL_MACHINE, conforme descrito abaixo. Observe que os aplicativos devem criar ProgIDs específicos do aplicativo para o protocolo de pesquisa.
- Reivindicar associação de protocolo de busca a nível de máquina.
- Registe a aplicação com Programas Predefinidos, conforme explicado em Registar uma Aplicação para Uso com Programas Predefinidos, como potencial candidato para o protocolo de pesquisa.
Entradas de registo
Seguem-se exemplos das entradas de registo necessárias para uma aplicação de pesquisa de ambiente de trabalho fictícia, a Pesquisa Contoso.
HKEY_LOCAL_MACHINE
SOFTWARE
Classes
contoso-search
URL Protocol = ""
HKEY_LOCAL_MACHINE
SOFTWARE
Classes
contoso-search
DefaultIcon
(Default) = %ProgramFiles%\Contoso\Search\contososearch.exe,-7
HKEY_LOCAL_MACHINE
SOFTWARE
Classes
contoso-search
shell
open
command
(Default) = %ProgramFiles%\Contoso\Search\contososearch.exe %1
HKEY_LOCAL_MACHINE
SOFTWARE
RegisteredApplications
Contoso Search = "Software\\Contoso\\Search\\Capabilities"
HKEY_LOCAL_MACHINE
SOFTWARE
Contoso
Search
Capabilities
ApplicationName = "Contoso Search Test App"
ApplicationDescription = "Contoso search is a great new desktop search application"
HKEY_LOCAL_MACHINE
SOFTWARE
Contoso
Search
Capabilities
UrlAssociations
search = "contoso-search"
Tópicos relacionados