Delen via


Een zoekconnector maken voor een protocolhandler

Windows Verkenner controleert het aanmaken van een zoekconnector voor een protocolverwerker door middel van registersleutels. Via het register kunnen zowel implementers als derden nieuwe en verouderde protocolhandlers inschakelen om deel te nemen aan Windows 7 Search.

Dit onderwerp is als volgt ingedeeld:

Over zoekconnectors voor protocolverwerkers in Windows 7

In Windows 7 bevatten zoekopdrachten vanuit het startmenu of Windows Verkenner alleen bestanden op geïndexeerde locaties en niet-bestandssysteemitems zoals externe gegevensarchieven of protocolhandleritems met een zoekconnector. Naast het opnemen van de protocolhandleritems in het bereik van menu Start menu en Shell-zoekopdrachten, stelt de zoekconnector het menu Start menu in staat om items van protocolhandlers samen te groeperen in startmenuresultaten, met het resulterende voordeel dat de gebruiker op de groepskoptekst kan klikken en alleen resultaten van de protocolhandler kan weergeven. De gebruiker kan ook naar de map Zoekopdrachten navigeren, het bestand van de zoekconnector openen en een zoekopdracht uitvoeren die alleen items uit de specifieke protocolhandler bevat die aan die zoekconnector zijn gekoppeld.

Wanneer een gebruiker voor het eerst een toepassing start die een protocolhandler registreert, genereert Windows Verkenner een zoekconnectorbestand (.searchConnector-ms) voor de protocolhandler in de Zoekopdrachten map van de gebruiker. Toepassingen met protocolhandlers kunnen ervoor kiezen dit gedrag uit te schakelen of de naam en beschrijving van de zoekconnector voor protocolhandlers aan te passen.

Notitie

De locatie van de map Zoekopdrachten van de gebruiker is %userprofile%\Searches, of FOLDERID_SavedSearches. De GUID voor FOLDERID_SavedSearches is {7d1d3a04-debb-4115-95cf-2f29da2920da}.

 

Windows Verkenner regelt het maken van een zoekconnector voor een protocolhandler met registersleutelvermeldingen die in de volgende secties worden beschreven.

Notitie

Er zijn geen programmatische methoden om een zoekconnector te maken voor een protocolhandler. Ze moeten worden geconfigureerd via het register.

 

Registersleutels en de mogelijke waarden worden beschreven in de volgende tabel. Een protocolhandler kan een aantal of al deze registersleutels vullen waarbij <protocol> wordt vervangen door de werkelijke naam van het protocol, zoals MAPI, bestand of csc, bijvoorbeeld.

Registersleutel Mogelijke waarde(en) Typ Opmerkingen
HKEY_LOCAL_MACHINE\Software\Microsoft\Windows Search\PHSearchConnectors\<protocol>\Version Bestaat niet (standaard). Anders is het 1 of hoger. REG_DWORD Deze waarde wordt gebruikt om wijzigingen in de locatiesjabloonregistraties te detecteren voor zoekwortels die al zijn verwerkt. Als dit niet het geval is, gebruikt u 0 als standaardwaarde. U kunt ook de versie verhogen om Windows Verkenner te informeren dat de zoekconnector opnieuw moet worden gegenereerd omdat er een nieuwere versie van de protocolhandler is geïnstalleerd.
HKEY_LOCAL_MACHINE\Software\Microsoft\Windows Search\PHSearchConnectors\<protocol>\DoNotCreateSearchConnectors Bestaat niet (standaard). In andere gevallen ingesteld op 1. REG_DWORD Als dit niet bestaat, maakt u een .searchconnector-ms-bestand in de map Zoekopdrachten. Als 1, markeert u als verwerkt en doet u niets.
HKEY_LOCAL_MACHINE\Software\Microsoft\Windows Search\PHSearchConnectors\<protocol>\Default\Beschrijving Een lokaliseerbare tekenreeks met de beschrijving van de zoekconnector. REG_SZ Facultatief. Het wordt gebruikt in het element Description van het bestand .searchconnector-ms.
HKEY_LOCAL_MACHINE\Software\Microsoft\Windows Search\PHSearchConnectors\<protocol>\Default\Name Een gelokaliseerde tekenreeks om de zoekconnector een naam te geven. Wordt gebruikt als de naam van het .searchconnector-ms-bestand. REG_SZ Elke locatie moet een unieke naam hebben. Als deze waarde ontbreekt, wordt de weergavenaam van de IShellFolder Interface van de protocolhandler gebruikt.
HKEY_LOCAL_MACHINE\Software\Microsoft\Windows Search\PHSearchConnectors\<protocol>\Default\FolderType Een GUID die de FOLDERTYPEID identificeert die moet worden toegepast op de zoekconnector. REG_SZ Facultatief. Wordt gebruikt in het element folderType van het bestand .searchconnector-ms om aan te geven welke sjablonen moeten worden gebruikt om resultaten weer te geven. Bijvoorbeeld de GUID-waarde van FOLDERTYPEID_Documents.

 

Het uitschakelen van het maken van de protocolhandler-zoekconnector

Als uw toepassing items beschikbaar maakt via een protocolhandler voor gebruik in de toepassing zelf en u de items niet beschikbaar wilt maken via de Shell (in menu Start en Zoekopdrachten in Windows Verkenner), moet u het maken van een zoekconnector voor uw protocolhandler uitschakelen.

Als u het maken van zoekconnectors wilt uitschakelen, stelt u DoNotCreateSearchConnectors in op 0x00000001(1), zoals wordt weergegeven in het volgende voorbeeld van de registersleutel.

HKEY_LOCAL_MACHINE
   Software
      Microsoft
         Windows Search
            PHSearchConnectors
               <protocol>
                  DoNotCreateSearchConnectors

Als DoNotCreateSearchConnectors is ingesteld op 1, raden we u aan om de eigenschap System.Shell.OmitFromView beschikbaar te maken voor elk item dat wordt weergegeven door de protocolhandler en de waarde van deze eigenschap in te stellen op TRUE-. Als u dit doet, worden de items van de protocolhandler niet weergegeven onder het menu StartBestanden groep.

Als DoNotCreateSearchConnectors aanwezig is en is ingesteld op nul, maakt Windows Verkenner een zoekconnector voor de protocolhandler en worden de items van de protocolhandler geretourneerd in menu Start menu en zoekopdrachten in Windows Verkenner.

Het aanpassen van de naam, omschrijving of foldertype voor een zoekconnector voor protocolhandlers

De naam van de zoekconnector wordt niet alleen gebruikt om de zoekconnector in de map Zoekopdrachten te identificeren, maar ook als groepskoptekst voor de resultaten in de zoekopdrachten van het menu Start. Daarom is het belangrijk om een beschrijvende naam op te geven voor de zoekconnector. Als er geen naam is opgegeven in de registersleutel, gebruikt Windows Verkenner standaard de naam verstrekt door IShellFolder Interface voor de zoekhoofdmap en blanco beschrijving van de protocolhandler. U kunt de standaardnaam overschrijven via een registersleutelvermelding zonder de naam van de IShellFolder-interface te hoeven wijzigen. Hoewel deze niet zo zichtbaar is als de naam van de zoekconnector, kunt u ook de beschrijving voor de zoekconnector overschrijven door uw eigen beschrijving op te geven.

Als u de standaardnaam of beschrijving wilt overschrijven, stelt u de vermeldingen in zoals wordt weergegeven in het volgende registervoorbeeld.

HKEY_LOCAL_MACHINE
   Software
      Microsoft
         Windows Search
            PHSearchConnectors
               <protocol>
                  Default
                     Name
                     Description

Bovendien kan de maptype-optie worden ingesteld op een van de FOLDERTYPEID GUID-groepen. De waarde moet de werkelijke GUID zijn en niet de naam. Bijvoorbeeld {94d6dcc-4a68-4175-a374-bd584a510b78} in plaats van FOLDERTYPEID_Music. De GUID voor een FOLDERTYPEID kan worden verkregen in het headerbestand Shlguid.h in de Windows SDK.

HKEY_LOCAL_MACHINE
   Software
      Microsoft
         Windows Search
            PHSearchConnectors
               <protocol>
                  Default
                     FolderType = {94d6ddcc-4a68-4175-a374-bd584a510b78}

Registerreeksomleiding gebruiken

U kunt een geredirecteerde tekenreeks gebruiken zodat de naam die u voor de zoekconnector opgeeft, gelokaliseerd kan worden. U kunt lokaliseerbare tekenreeksen voor de naam en beschrijving van registersleutels opnemen in plaats van de werkelijke tekenreeks in het register in te voeren.

Als u een lokaliseerbare tekenreeks wilt opnemen voor de waarden voor de naam of beschrijving, stelt u de waarde in zoals wordt weergegeven in het volgende voorbeeld van de registersleutel.

HKEY_LOCAL_MACHINE
   Software
      Microsoft
         Windows Search
            PHSearchConnectors
               <protocol>
                  Name = @dllname.dll,-resourceID

De lokaliseerbare tekenreeks heeft de volgende indeling:

  • @dllname.dll,-resourceID, waarbij:
    • @dllname.dll is het pad naar het DLL-bestand dat de tekenreeksresource bevat
    • resourceID is de integer-resource-ID van de tekenreeksresource.

De indeling voor een indirecte tekenreeks en een indirecte tekenreeks die is toegevoegd aan een versieaanpassingsfunctie, wordt beschreven in SHLoadIndirectString Function.

De zoekconnector van een verwijderde protocolhandler herstellen

Omdat zoekconnectors bestanden op de computer van de gebruiker zijn, kunnen ze per ongeluk worden verwijderd. Als u alle verwijderde protocolhandlerzoekconnectors wilt herstellen, moet u de standaardbibliotheken herstellen. Hiervoor opent u Windows Verkenner, klikt u met de rechtermuisknop op de map Bibliotheken en selecteert u Standaardbibliotheken herstellen.

schermafbeelding met de menuoptie Standaardbibliotheken herstellen

Aanvullende informatiebronnen

conceptuele

Protocolhandlers begrijpen

Protocolhandlers ontwikkelen

de index van wijzigingen melden

pictogrammen en contextmenu's toevoegen

codevoorbeeld: Shell-extensies voor protocolhandlers

Protocolhandlers Installeren en Registreren

Protocolhandlers voor foutopsporing