Keresési összekötő létrehozása protokollkezelőhöz

A Windows Intéző a rendszerleíró adatbázis kulcsbejegyzésein keresztül szabályozza a protokollkezelő keresési csatlakozójának létrehozását. A beállításjegyzéken keresztül mind a implementátorok, mind a harmadik felek engedélyezhetik az új és örökölt protokollkezelők számára, hogy részt vehessenek a Windows 7 Search szolgáltatásban.

Ez a témakör a következőképpen van rendszerezve:

A Protokollkezelők keresési összekötőinek ismertetése a Windows 7-ben

A Windows 7 rendszerben a Start menüből vagy a Windows Intézőből való keresések csak az indexelt helyeken lévő fájlokat és a nem fájlrendszerbeli elemeket, például távoli adattárakat vagy a keresési összekötővel rendelkező protokollkezelő elemeket tartalmazzák. Amellett, hogy a protokollkezelő elemeket belefoglalja a Start menü és a Shell-keresések hatókörébe, a keresési összekötő lehetővé teszi, hogy a Start menüben a protokollkezelő elemeket együtt csoportosítsa a Start menü eredményei között, és ennek az az előnye, hogy a felhasználó csak a protokollkezelőtől kattinthat a csoportfejlécre, és megtekintheti az eredményeket. Másik lehetőségként a felhasználó megkeresheti a Keresések mappát, megnyithatja a keresési összekötőfájlt, és olyan keresést hajthat végre, amely csak a keresési összekötőhöz társított protokollkezelő elemeit tartalmazza.

Amikor egy felhasználó először elindít egy protokollkezelőt regisztráló alkalmazást, a Windows Explorer létrehoz egy keresési összekötőfájlt (.searchConnector-ms) a protokollkezelőhöz a felhasználó Keresés mappájában. A protokollkezelőkkel rendelkező alkalmazások letilthatják ezt a viselkedést, vagy testre szabhatják a protokollkezelő keresési összekötőjének nevét és leírását.

Jegyzet

A felhasználó Keresések mappájának helye %userprofile%\Keresések vagy FOLDERID_SavedSearches. A FOLDERID_SavedSearches mappához tartozó GUID azonosító {7d1d3a04-debb-4115-95cf-2f29da2920da}.

 

A Windows Explorer az alábbi szakaszokban ismertetett beállításkulcs-bejegyzéseken keresztül szabályozza egy protokollkezelő modul keresési csatlakozójának létrehozását.

Jegyzet

Nincs programozott eszköz a protokollkezelő keresési összekötőjének létrehozására. Ezeket a beállításjegyzéken keresztül kell konfigurálni.

 

A beállításkulcsokat és azok lehetséges értékeit az alábbi táblázat ismerteti. A protokollkezelő feltöltheti a beállításkulcsok egy részét vagy mindegyikét, ahol a <protokoll> helyére a protokoll tényleges neve kerül, mint például MAPI, fájl vagy csc.

Regisztrációs kulcs Lehetséges érték(ek) Típus Megjegyzések
HKEY_LOCAL_MACHINE\Software\Microsoft\Windows Search\PHSearchConnectors\<protokoll>\Verzió Nem létezik (alapértelmezett). Ellenkező esetben 1 vagy nagyobb. REG_DWORD Ez az érték a már feldolgozott keresési gyökerek helysablon-regisztrációinak változásainak észlelésére szolgál. Ha nem létezik, használja alapértelmezésként a 0 értéket. Másik lehetőségként növelje a verziót, hogy tájékoztassa a Windows Intézőt arról, hogy a keresési összekötőt újra kell létrehozni, mert a protokollkezelő újabb verziója telepítve van.
HKEY_LOCAL_MACHINE\Software\Microsoft\Windows Search\PHSearchConnectors\<protokoll>\DoNotCreateSearchConnectors Nem létezik (alapértelmezett). Ellenkező esetben állítsa be az 1 értéket. REG_DWORD Ha nem létezik, hozzon létre egy .searchconnector-ms fájlt a Keresések mappában. Ha 1, jelölje meg a feldolgozottként, és ne tegyen semmit.
HKEY_LOCAL_MACHINE\Software\Microsoft\Windows Search\PHSearchConnectors\<protokoll>\Default\Description A keresési összekötő leírását tartalmazó honosítható karakterlánc. REG_SZ Szabadon választható. A .searchconnector-ms fájl Leírás elemében használatos.
HKEY_LOCAL_MACHINE\Software\Microsoft\Windows Search\PHSearchConnectors\<protokoll>\Default\Name Egy honosított sztring, amely a keresési összekötőnek ad nevet. A .searchconnector-ms fájl neveként használatos. REG_SZ Minden helynek egyedi névvel kell rendelkeznie. Ennek az értéknek a hiányában a protokollkezelő IShellFolder interface által megadott megjelenítendő nevet fogja használni.
HKEY_LOCAL_MACHINE\Software\Microsoft\Windows Search\PHSearchConnectors\<protokoll>\Default\FolderType A keresési összekötőre alkalmazandó FOLDERTYPEID GUID azonosító. REG_SZ Szabadon választható. A .searchconnector-ms fájl folderType elemében használva jelzi, hogy milyen sablonokat kell használni az eredmények megjelenítéséhez. Például a FOLDERTYPEID_Documents GUID-értéke.

 

A protokollkezelő keresési összekötő létrehozásának letiltása

Ha az alkalmazás egy protokollkezelőn keresztül teszi elérhetővé az elemeket az alkalmazásban való használatra, és nem szeretné az elemeket a Shellen keresztül elérhetővé tenni (a Start menüben és a Windows Intéző kereséseiben), le kell tiltania a protokollkezelő keresési összekötőjének létrehozását.

A keresési összekötő létrehozásának letiltásához állítsa be a DoNotCreateSearchConnectorst 0x00000001(1) értékre, ahogyan az alábbi beállításkulcs-példában látható.

HKEY_LOCAL_MACHINE
   Software
      Microsoft
         Windows Search
            PHSearchConnectors
               <protocol>
                  DoNotCreateSearchConnectors

Ha a DoNotCreateSearchConnectors értéke 1, javasoljuk, hogy tegye elérhetővé a System.Shell.OmitFromView tulajdonságot a protokollkezelő által közzétett minden elemen, és állítsa a tulajdonság értékét a TRUE . Ez megakadályozza, hogy a protokollkezelő elemek megjelenjenek a Start menüben Fájlok csoportban.

Ha a DoNotCreateSearchConnectors értéke nulla, akkor a Windows Intéző létrehoz egy keresési összekötőt a protokollkezelőhöz, és a protokollkezelő elemei a Start menüben és a Windows Intéző kereséseiben jelennek meg.

A protokollkezelő keresési összekötő nevének, leírásának vagy Mappatípusának testreszabása

A keresési összekötő neve nem csak a Keresések mappában található keresési összekötő azonosítására szolgál, hanem a Start menübeli keresések eredményének csoportfejléceként is. Ezért fontos, hogy leíró nevet adjon a keresési összekötőnek. Ha a beállításkulcs nem ad meg nevet, a Windows Intéző alapértelmezés szerint az IShellFolder Interface által megadott nevet használja a protokollkezelő keresési gyökér- és üres leírásához. Az alapértelmezett nevet felülbírálhatja egy beállításkulcs-bejegyzésen keresztül anélkül, hogy át kellene neveznie az IShellFolder-felületet. Bár nem olyan látható, mint a keresési összekötő neve, saját leírás megadásával felülbírálhatja a keresési összekötő leírását is.

Az alapértelmezett név vagy leírás felülbírálásához állítsa be a bejegyzéseket az alábbi beállításjegyzék-példában látható módon.

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

Emellett a FolderType bejegyzés a FOLDERTYPEID GUID-ek egyikére is beállítható. Az értéknek a tényleges GUID-nak kell lennie, nem pedig a nevének. Például{ 94d6ddcc-4a68-4175-a374-bd584a510b78} FOLDERTYPEID_Music helyett. A FOLDERTYPEID guid azonosítója a Windows SDKShlguid.h fejlécfájljában kérhető le.

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

Beállításjegyzék-string átirányításának használata

Egy átirányított sztring használatával biztosíthatja, hogy a keresési összekötőhöz megadott név honosítható legyen. A név és leírás beállításkulcsaihoz honosítható sztringeket is használhat, a tényleges sztring beírása helyett a registrybe.

Ha egy honosítható sztringet szeretne hozzáadni a Név vagy Leírás értékekhez, állítsa be az értéket az alábbi beállításkulcs-példában látható módon.

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

A honosítható sztring formátuma a következő:

  • @dllname.dll,-resourceID, ahol:
    • @dllname.dll a sztringerőforrást tartalmazó DLL elérési útja
    • a resourceID a sztringerőforrás egész számú erőforrás-azonosítója

A közvetett string formátumát, valamint a verziómódosítóval ellátott közvetett stringet a SHLoadIndirectString függvényismerteti.

Törölt protokollkezelő keresési összekötőjének visszaállítása

Mivel a keresési összekötők fájlok a felhasználó számítógépén, tévesen törölhetők. A törölt protokollkezelő keresési összekötőinek visszaállításához állítsa vissza az alapértelmezett kódtárakat. Ehhez nyissa meg a Windows Intézőt, kattintson a jobb gombbal a Tárak mappára, majd válassza Alapértelmezett könyvtárak visszaállításalehetőséget.

képernyőfelvétel a visszaállítás alapértelmezett kódtárak menübeállításával

További erőforrások

fogalmi

Protokollkezelők ismertetése

Protokollkezelők fejlesztése

Változások indexének értesítése

Ikonok és helyi menük hozzáadása

kódminta: A Protokollkezelők rendszerhéjbővítményei

Protokollkezelők telepítése és regisztrálása

hibakeresési protokollkezelők