Delen via

Het zoekprotocol gebruiken

  • Artikel

De zoeken:toepassingsprotocol is een uitbreidbare conventie voor het aanroepen van de bureaubladzoektoepassing op Windows Vista met Service Pack 1 (SP1) en latere versies. Het protocol is gemaakt in Windows Vista met SP1 om Windows een manier te geven om de standaardtoepassing voor bureaubladzoekopdrachten te bepalen en aan te roepen.

De protocolsyntaxis biedt een aantal parameters die handig zijn voor het uitvoeren van algemene zoekopdrachten op het bureaublad, zoals door de gebruiker ingevoerde zoektermen of de locatie waarop de zoekopdracht is gestart. Wanneer gebruikers zoeken vanuit een van de twee beschikbare zoekinvoerpunten (het menu Start of Windows Verkenner), gebruikt het besturingssysteem het zoekprotocol om de standaardtoepassing voor zoeken op het bureaublad te starten. Dit doet u door de door de gebruiker ingevoerde zoektermen toe te voegen aan de standaard syntaxis van het zoekprotocol en die informatie door te geven aan de toepassing die is geregistreerd als de standaardzoektoepassing.

Als er geen andere bureaubladzoektoepassingen zijn geïnstalleerd, wordt de Windows Search Explorer gestart door een zoekopdracht die in deze toegangspunten is ingevoerd. Externe ontwikkelaars kunnen echter hun toepassingen maken, installeren en registreren om het zoekprotocol af te handelen en om de standaardzoektoepassing te zijn. Dergelijke toepassingen moeten de syntaxis van het zoekprotocol ondersteunen en zich registreren bij de functie Standaardprogramma's om een naadloze ervaring met Windows te garanderen.

Als u een toepassing ontwikkelt die is bedoeld om een specifieke bureaubladzoektoepassing te gebruiken of voort te bouwen, moet u niet uitsluitend afhankelijk zijn van de zoekopdracht: protocol. Omdat veel toepassingen eigenaar kunnen zijn van het zoekopdracht: protocol, is er geen garantie dat uw bureaubladzoektoepassing er op enig moment eigenaar van is. In plaats daarvan moet u een privézoekprotocol gebruiken dat is gedefinieerd door die doeltoepassing voor zoeken op het bureaublad. Dit betekent dat desktopzoekapplicaties die bedoeld zijn als platform voor toepassingen van derden zowel het zoeken: protocol als hun eigen zoekprotocol moeten ondersteunen.

Notitie

Het zoek: protocol vervangt niet het eigen search-ms: protocol. Toepassingen kunnen nog steeds gebruikmaken van de search-ms: protocol om Windows Search Explorer te starten of om op de achtergrond een query uit te voeren op de Indexeerfunctie van Windows Search.

 

In dit onderwerp wordt het volgende behandeld:

Syntaxis

Het zoekprotocol maakt gebruik van de volgende standaard-URL-gecodeerde syntaxis:

search:parameter=value[&parameter=value]&

De syntaxis begint met het identificeren van het protocol zelf (zoekopdracht:). De parameter-/waardeparen zijn argumenten die worden doorgegeven aan de zoekmachine, zoals beschreven in de volgende tabel, waarin alle mogelijke parameters voor de syntaxis van het zoekprotocol worden weergegeven.

Parameter Waarde Beschrijving
vraag Door URL gecodeerde tekst De querytekst die door de gebruiker is ingevoerd.
invoerlandinstelling Elke geldige taalcode-id (LCID) De LCID die de invoertaal voor de query identificeert.
trefwoordlokalisatie Elke geldige LCID De LCID die de taal van de internationale versie van de indexeerfunctie identificeert. De standaardwaarde is 1033 (en-us).
kruimel AQS-verklaring Dit argument beperkt het bereik dat wordt doorzocht. In Windows Vista ondersteunt het zoekprotocol volledige AQS en een speciale implementatie voor een location argument. In Windows XP ondersteunt het zoekprotocol ook volledige AQS, met uitzondering van een speciale implementatie van kind en store.
syntaxis NQS, AQS (niet hoofdlettergevoelig) De querysyntaxis die moet worden gebruikt om de index te doorzoeken: natuurlijke querysyntaxis of geavanceerde querysyntaxis (AQS). AQS is de standaardinstelling en wordt altijd geparseerd en ondersteund.
gestapelde Elke geldige eigenschap van het eigenschappensysteem Een eigenschap waarmee de kolom wordt opgegeven waarop de resultaten moeten worden gestapeld.
subquery Een volledig opgegeven pad voor een opgeslagen zoekbestand (*.search-ms) De resultaten van de subquery worden gebruikt als de bron voor de query. Dat wil gezegd, de querytermen worden doorzocht op basis van de resultaten van de subquery.
weergavenaam URL-gecodeerde tekenreeks De naam van de huidige zoekopdracht.

 

Het gebruik van het zoekprotocol in Windows Vista met SP1.

Windows Vista met SP1 heeft verschillende toegangspunten waaruit de zoekopdracht wordt aanroepen: protocol. Deze toegangspunten worden hieronder beschreven, evenals de algemene syntaxis die aan elk item is gekoppeld.

Toegangspunt voor zoekprotocol Plaats Query aangeroepen
Overal zoeken Startmenu search:query=<Zoekterm>
Overal zoeken Windows Verkenner search:query=<zoekterm>&kruimel=locatie:<LOCATIE>
Windows-logotoets + F Ergens zoeken:
Ctrl+F Windows Verkenner search:query=<zoekterm>&kruimel=locatie:<LOCATION>
F3 Startmenu zoeken:
F3 Windows Verkenner search:query=<zoekterm>&kruimel=locatie:<LOCATIE>

 

Windows Vista met SP1 zoekprotocolinvoerpunten profiteren niet van alle mogelijke parameters in het zoekprotocol. Toepassingen die alleen betrekking hebben op het verwerken van zoekprotocol-aanroepen van Windows Vista met SP1 kunnen de volgende tabel gebruiken als richtlijn voor het minimum dat ze moeten implementeren.

Parameter Gebruikt door Windows? Hoe Windows Vista met SP1 deze gebruikt bij het aanroepen van zoekopdrachten:
vraag Ja De querytekst die door de gebruiker is ingevoerd.
kruimel Ja kruimel het argument location gebruikt om op te geven waar de query vandaan komt.
subquery Ja De resultaten van het argument Subquery worden gebruikt als het zoekbereik van items. Dit zou doorgaans worden gebruikt wanneer een gebruiker een .search-ms-bestand gebruikt om te zoeken en vervolgens de standaard bureaubladzoektoepassing vanuit die zoekopdracht start.
inputlocale- Nee Momenteel niet gebruikt.
sleutelwoordlocatie Nee Momenteel niet gebruikt.
syntaxis Nee Momenteel niet gebruikt.
gestapelde Nee Momenteel niet gebruikt.
weergavenaam Nee Momenteel niet gebruikt.

 

Voorbeelden

Als een gebruiker 'Microsoft' invoert in het menu Start en op Zoeken overalklikt, wordt de resulterende aanroep van het zoekprotocol uitgevoerd:

search:query=microsoft&

Als een gebruiker 'Seattle' invoert in Windows Verkenner in C:\MyFolder en vervolgens op Zoeken overalklikt, wordt de volgende aanroep uitgevoerd, met behulp van escapetekens voor :en \:

search:query=seattle&crumb=location:C%3A%5CMyFolder

De toepassing registreren die het protocol afhandelt

Omdat meerdere toepassingen kunnen strijden voor het zoekprotocol, moet u uw toepassing registreren bij de standaardprogramma's functie tijdens de installatie, zodat de gebruiker de standaardinstelling gemakkelijker kan configureren. Naast de installatieprocedures die normaal worden gebruikt onder Windows XP, moet een windows Vista-toepassing zich registreren bij de functie Standaardprogramma's, zodat de toepassing en gebruikers naadloos standaardinstellingen kunnen configureren.

Nadat u de benodigde binaire bestanden op de computer van de gebruiker hebt geïnstalleerd, moet uw installatieroutine deze algemene taken uitvoeren:

  1. Schrijf ProgID's naar HKEY_LOCAL_MACHINE, zoals hieronder wordt beschreven. Toepassingen moeten toepassingsspecifieke ProgID's maken voor het zoekprotocol.
  2. Zoekprotocolkoppeling op computerniveau claimen.
  3. Registreer de toepassing bij Standaardprogramma's, zoals wordt uitgelegd in Een toepassing registreren voor gebruik met standaardprogramma's, als een strijder voor het zoekprotocol.

Registervermeldingen

Hier volgen enkele voorbeelden van de vereiste registervermeldingen voor een fictieve bureaubladzoektoepassing, Contoso Search.

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"

Geavanceerde Query Syntax

standaardprogramma's