Protokollkezelők telepítése és regisztrálása (Windows Search)

A protokollkezelő telepítésekor a DLL-eket a Program Files könyvtár megfelelő helyére kell másolni, majd regisztrálni kell a protokollkezelőt a beállításjegyzéken keresztül. A telepítőalkalmazás keresési gyökér- és hatókörszabályokat is hozzáadhat a Shell-adatforrás alapértelmezett bejárási hatókörének meghatározásához.

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

• Az URL-címek
• Protokollkezelő felületek implementálása
  • ISearchProtocol és ISearchProtocol2
  • IUrlAccessor, IUrlAccessor2, IUrlAccessor3 és IUrlAccessor4
  • IProtocolHandlerSite
• Tárolók szűrőkezelőinek implementálása
• Protokollkezelő telepítése és regisztrálása
  • protokollkezelő regisztrálásának irányelvei
  • Protokollkezelő regisztrálása
  • A protokollkezelő fájltípus-kezelőjének regisztrálása
• Annak biztosítása, hogy az elemeid indexelve legyenek
• Kapcsolódó témakörök

Tudnivalók az URL-címekről

A Windows Search URL-címekkel azonosítja a Shell-adatforrás hierarchiájában lévő elemeket. A hierarchia első csomópontjának URL-címét keresési gyökér-nek nevezzük. A Windows Search az indexelést a keresési gyökérnél kezdi, és kéri, hogy a protokollkezelő sorolja fel az egyes URL-címek gyermekhivatkozásait.

A tipikus URL-struktúra a következő:

<protocol>:// [{user SID}/] <localhost>/<path>/[<ItemID>]

Az URL-szintaxist az alábbi táblázat ismerteti.

A Windows Search Indexer levágja a végleges perjelet az URL-címekről. Ennek eredményeképpen nem támaszkodhat arra, hogy a könyvtár és az elem azonosításához van-e záró perjel. A protokollkezelőnek képesnek kell lennie kezelni ezt az URL-szintaxist. Győződjön meg arról, hogy a Shell-adatforrás azonosításához kiválasztott protokollnév nem ütközik az aktuálisakkal. Ezt az elnevezési konvenciót javasoljuk: companyName.scheme.

További információ a Shell-adatforrások létrehozásáról: Az alapszintű mappaobjektum-felületek implementálása.

Protokollkezelő felületek implementálása

A protokollkezelő létrehozásához a következő három felület implementálása szükséges:

• ISearchProtocol urlAccessor-objektumok kezeléséhez.
• IUrlAccessor a tulajdonságok felfedéséhez és a Shell-adatforrás elemeinek megfelelő szűrőinek azonosításához.
• IFilter a védett fájlok szűréséhez, illetve a hierarchikusan tárolt fájlok számbavételéhez és szűréséhez.

A felsorolt három kötelező interfészen kívül a többi interfész nem kötelező, és ön szabadon implementálhatja, hogy melyik választható interfész a legmegfelelőbb a feladathoz.

ISearchProtocol és ISearchProtocol2

A SearchProtocol-felületek inicializálják és kezelik a protokollkezelő URLAccessor-objektumait. Az ISearchProtocol2 felület a ISearchProtocolopcionális bővítménye, és egy további módszert is tartalmaz a felhasználóra és az elemre vonatkozó további információk megadásához.

Iurlaccessor, iurlaccessor2, iurlaccessor3 és IUrlAccessor4

Az IUrlAccessor interfészeket az alábbi táblázat ismerteti.

Az UrlAccessor objektumot egy SearchProtocol-objektum példányosít és inicializálja. Az IUrlAccessor felületek az alábbi táblázatban ismertetett módszerekkel biztosítják a fontos információkhoz való hozzáférést.

IProtocolHandlerSite

Az IProtocolHandlerSite felület egy izolált folyamat által üzemeltetett szűrőkezelő példányosítására szolgál. A rendszer beszerezi a megfelelő szűrőkezelőt egy megadott állandó osztályazonosítóhoz (CLSID), dokumentumtárolási osztályhoz vagy fájlnévkiterjesztéshez. Az az előnye, ha a gazdafolyamatot kérjük meg az iFilterkötésére, hogy a gazdafolyamat felügyelheti a megfelelő szűrőkezelő megkeresésének folyamatát, és szabályozhatja a kezelő meghívásának biztonságát.

Szűrőkezelők implementálása tárolókhoz

Ha hierarchikus protokollkezelőt implementál, akkor egy szűrőkezelőt kell implementálnia egy olyan tárolóhoz, amely számba adja a gyermek URL-címeket. A szűrőkezelő az IFilter felület implementációja. Az enumerálási folyamat az IFilter::GetChunk és IFilter::GetValue metódusai köré szervezett ciklus az IFilter felületen keresztül; minden gyermek URL-cím a tulajdonság értékeként jelenik meg.

IFilter::GetChunk a tároló tulajdonságait adja vissza. A gyermek URL-címek számbavételéhez IFilter::GetChunk az alábbiak egyikét adja vissza:

• PKEY_Search_UrlToIndex:

  Az elem URL-címe az utolsó módosítás időpontja nélkül. IFilter::GetValue a gyermek URL-címét tartalmazó PROPVARIANT értéket ad vissza.

• PKEY_Search_UrlToIndexWithModificationTime:

  Az URL-cím és az utolsó módosítás időpontja. IFilter::GetValue a gyermek URL-címének vektorát és az utolsó módosított időpontot tartalmazó PROPVARIANT értéket adja vissza.

A PKEY_Search_UrlToIndexWithModificationTime visszaadása hatékonyabb, mert az indexelő azonnal megállapíthatja, hogy az elemet indexelni kell-e az ISearchProtocol::CreateAccessor és IUrlAccessor::GetLastModified metódus meghívása nélkül.

Az alábbi példakód bemutatja, hogyan lehet visszaadni a PKEY_Search_UrlToIndexWithModificationTime tulajdonságot.

// Parameters are assumed to be valid

HRESULT GetPropVariantForUrlAndTime
    (PCWSTR pszUrl, const FILETIME &ftLastModified, PROPVARIANT **ppPropValue)
{
    *ppPropValue = NULL;

    // Allocate the propvariant pointer.
    size_t const cbAlloc = sizeof(**ppPropValue);
    *ppPropValue = (PROPVARIANT *)CoTaskMemAlloc(cbAlloc));

    HRESULT hr = *ppPropValue ? S_OK : E_OUTOFMEMORY;

    if (SUCCEEDED(hr))
    {
        PropVariantInit(*ppPropValue);  // Zero init the value

        // Now allocate enough memory for 2 nested PropVariants.
        // PKEY_Search_UrlToIndexWithModificationTime is an array of two PROPVARIANTs.
        PROPVARIANT *pVector = (PROPVARIANT *)CoTaskMemAlloc(sizeof(*pVector) * 2);
        hr = pVector ? S_OK : E_OUTOFMEMORY;

        if (SUCCEEDED(hr))
        {
            // Set the container PROPVARIANT to be a vector of two PROPVARIANTS.
            (*ppPropValue)->vt = VT_VARIANT | VT_VECTOR;
            (*ppPropValue)->capropvar.cElems = 2;
            (*ppPropValue)->capropvar.pElems = pVector;
            PWSTR pszUrlAlloc;
            hr = SHStrDup(pszUrl, &pszUrlAlloc);

            if (SUCCEEDED(hr))
            {
                // Now fill the array of PROPVARIANTS.
                // Put the pointer to the URL into the vector.
                (*ppPropValue)->capropvar.pElems[0].vt = VT_LPWSTR; 
                (*ppPropValue)->capropvar.pElems[0].pwszVal = pszUrlAlloc;

                 // Put the FILETIME into vector.
                (*ppPropValue)->capropvar.pElems[1].vt = VT_FILETIME; 
                (*ppPropValue)->capropvar.pElems[1].filetime = ftLastModified;
            }

            else
            {
                CoTaskMemFree(pVector);
            }
        }
 
        if (FAILED(hr))
        {
            CoTaskMemFree(*ppPropValue);
            *ppPropValue = NULL;
        }
    }
    return S_OK;
}

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

A protokollkezelők telepítésével a DLL-eket a Program Files könyvtár megfelelő helyére kell másolni, majd regisztrálni kell a DLL-eket. A protokollkezelőknek önregisztrációt kell implementálniuk a telepítéshez. A telepítőalkalmazás keresési gyökér- és hatókörszabályokat is hozzáadhat a Shell-adatforrás alapértelmezett bejárási hatókörének meghatározásához, amelyről a témakör végén Az elemek indexelésének biztosítása című témakörben olvashat.

Protokollkezelő regisztrálásának irányelvei

Protokollkezelő regisztrálásakor kövesse az alábbi irányelveket:

• A telepítőnek EXE vagy MSI telepítőt kell használnia.
• A kibocsátási megjegyzéseket meg kell adni.
• Minden telepített bővítményhez létre kell hozni egy Programok hozzáadása/eltávolítása bejegyzést.
• A telepítőnek át kell vennie az aktuális bővítmény által megismert fájltípus vagy -tároló beállításjegyzék-beállításait.
• Ha felülír egy korábbi bővítményt, a telepítőnek értesítenie kell a felhasználót.
• Ha egy újabb bővítmény felülírta az előző bővítményt, képesnek kell lennie visszaállítani az előző bővítmény funkcióit, és ismét az adott fájltípus alapértelmezett bővítményének kell lennie.
• A telepítőnek meg kell határoznia az indexelő alapértelmezett bejárási hatókörét egy keresési gyökér és hatókörszabályok hozzáadásával a Bejárási hatókörkezelő (CSM) használatával.

Protokollkezelő regisztrálása

A protokollkezelő összetevő regisztrálásához tizennélyes bejegyzést kell létrehoznia a beállításjegyzékben, ahol:

• Ver_Ind_ProgID a protokollkezelő implementáció verziófüggetlen ProgID azonosítója.
• Ver_Dep_ProgID a protokollkezelő implementáció verziófüggő ProgID azonosítója.
• CLSID_1 a protokollkezelő implementáció CLSID azonosítója.

Protokollkezelő regisztrálása:

1. Regisztrálja a verziófüggetlen ProgID-t a következő kulcsokkal és értékekkel:

   HKEY_CLASSES_ROOT
      <Ver_Ind_ProgID>
         (Default) = <Protocol Handler Class Description>
   

   HKEY_CLASSES_ROOT
      <Ver_Ind_ProgID>
         CLSID
            (Default) = {CLSID_1}
   

   HKEY_CLASSES_ROOT
      <Ver_Ind_ProgID>
         CurVer
            (Default) = <Ver_Dep_ProgID>
   

2. Regisztrálja a verziófüggő ProgID-t a következő kulcsokkal és értékekkel:

   HKEY_CLASSES_ROOT
      <Ver_Dep_ProgID>
         (Default) = <Protocol Handler Class Description>
   

   HKEY_CLASSES_ROOT
      <Ver_Dep_ProgID>
         CLSID
            (Default) = {CLSID_1}
   

3. Regisztrálja a protokollkezelő CLSID azonosítóját a következő kulcsokkal és értékekkel:

   HKEY_CLASSES_ROOT
      {CLSID_1}
         (Default) = <Protocol Handler Class Description>
   

   HKEY_CLASSES_ROOT
      {CLSID_1}
         {InprocServer32}
            (Default) = <DLL Install Path>
            Threading Model = Both
   

   HKEY_CLASSES_ROOT
      {CLSID_1}
         <ProgID>
            (Default) = <Ver_Dep_ProgID>
   

   HKEY_CLASSES_ROOT
      {CLSID_1}
         <ShellFolder>
            Attributes = dword:a0180000
   

   HKEY_CLASSES_ROOT
      {CLSID_1}
         TypeLib
            (Default) = {LIBID of PH Component}
   

   HKEY_CLASSES_ROOT
      {CLSID_1}
         VersionIndependentProgID
            (Default) = <Ver_Ind_ProgID>
   

4. Regisztrálja a protokollkezelőt a Windows Search szolgáltatásban. Az alábbi példában <protokollnév> maga a protokoll neve, például fájl, mapi stb.:

   HKEY_LOCAL_MACHINE
      SOFTWARE
         Microsoft
            Windows Search
               ProtocolHandlers
                  <Protocol Name> = <Ver_Dep_ProgID>
   

   HKEY_CURRENT_USER
      SOFTWARE
         Microsoft
            Windows Search
               ProtocolHandlers
                  <Protocol Name> = <Ver_Dep_ProgID>
   

   Windows Vista előtt:

   HKEY_CURRENT_USER
      SOFTWARE
         Microsoft
            Windows Desktop Search
               DS
                  Index
                     ProtocolHandlers
                        <Protocol Name>
                           HasRequirements = dword:00000000
                           HasStartPage = dword:00000000
   

A protokollkezelő fájltípus-kezelőjének regisztrálása

A protokollkezelő fájltípus-kezelőjének (más néven Shell-bővítménynek) regisztrálásához két bejegyzést kell létrehoznia a beállításjegyzékben.

1. HKEY_LOCAL_MACHINE
      SOFTWARE
         Microsoft
            Windows
               CurrentVersion
                  Explorer
                     Desktop
                        NameSpace
                           {CLSID of PH Implementation}
                              (Default) = <Shell Implementation Description>
   

2. HKEY_LOCAL_MACHINE
      SOFTWARE
         Microsoft
            Windows
               CurrentVersion
                  Explorer
                     Shell Extensions
                        Approved
                           {CLSID of PH Implementation} = <Shell Implementation Description>
   

Az elemek indexelésének biztosítása

A protokollkezelő implementálása után meg kell adnia, hogy a protokollkezelő mely Shell-elemeket indexelje. A Catalog Managerrel újraindexelést kezdeményezhet (további információ: A Catalog Managerhasználata). A bejárási hatókör-kezelővel (CSM) is beállíthatja az indexelő által bejárni kívánt URL-címeket jelző alapértelmezett szabályokat (további információ: A bejárási hatókör-kezelő és Hatókörszabályok kezelése). Keresési gyökereket is hozzáadhat (további információ: Keresési gyökerek kezelése). Egy másik lehetőség az, hogy kövesse az eljárást a ReIndex mintában Windows keresési kódminták.

Az ISearchCrawlScopeManager felület olyan metódusokat biztosít, amelyek értesítik a keresőmotort a bejárásra és/vagy megtekintésre szolgáló tárolókról, valamint a tárolók alatti elemekről, amelyeket bejárás vagy figyelés során belefoglalnak vagy kizárnak. Windows 7 és újabb verziókban ISearchCrawlScopeManager2 kibővíti ISearchCrawlScopeManager a ISearchCrawlScopeManager2::GetVersion metódussal, amely lekéri a verziót, amely tájékoztatja az ügyfeleket arról, hogy megváltozott-e a CSM állapota.

Kapcsolódó témakörök

Koncepcionális

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

Keresési összekötő létrehozása egy protokollkezelő számára

hibakeresési protokollkezelők