Condividi tramite

Creazione di un connettore di ricerca per un gestore del protocollo

Esplora risorse controlla la creazione di un connettore di ricerca per un gestore di protocolli tramite voci di chiave del Registro di sistema. Tramite il Registro di sistema, sia gli implementatori sia le terze parti possono abilitare i gestori di protocolli nuovi e legacy a partecipare alla ricerca di Windows 7.

Questo argomento è organizzato come segue:

Informazioni sui connettori di ricerca per i gestori di protocollo in Windows 7

In Windows 7, le ricerche dal menu Start o Esplora risorse di Windows includono solo file in percorsi indicizzati e elementi che non fanno parte del file system, ad esempio archivi remoti di dati o elementi del gestore di protocollo che dispongono di un connettore di ricerca. Oltre a includere gli elementi del gestore del protocollo nell'ambito del menu Start e delle ricerche shell, il connettore di ricerca consente al menu Start di raggruppare gli elementi del gestore del protocollo insieme nei risultati del menu Start , in modo che l'utente possa fare clic sull'intestazione del gruppo e visualizzare i risultati solo dal gestore del protocollo. In alternativa, l'utente può passare alla cartella Ricerche, aprire il file del connettore di ricerca ed eseguire una ricerca che includa solo gli elementi del gestore di protocollo specifico associato a tale connettore di ricerca.

Quando un utente avvia per la prima volta un'applicazione che registra un gestore di protocollo, Esplora file genera un file del connettore di ricerca (con estensione .searchConnector-ms) per il gestore del protocollo nella cartella Ricerche dell'utente. Le applicazioni con gestori di protocollo possono scegliere di disabilitare questo comportamento o personalizzare il nome e la descrizione del connettore di ricerca del gestore del protocollo.

Nota

Il percorso della cartella cerca dell'utente è %userprofile%\Cerca o FOLDERID_SavedSearches. Il GUID per FOLDERID_SavedSearches è {7d1d3a04-debb-4115-95cf-2f29da2920da}.

 

Esplora file controlla la creazione di un connettore di ricerca per un gestore dei protocolli tramite voci del Registro di sistema descritte nelle sezioni seguenti.

Nota

Non esistono mezzi programmatici per creare un connettore di ricerca per un gestore di protocollo. Devono essere configurati tramite il Registro di sistema.

 

Le chiavi del Registro di sistema e i relativi valori possibili sono descritti nella tabella seguente. Un gestore di protocolli può popolare alcune o tutte queste chiavi del Registro di sistema in cui <protocollo> viene sostituito con il nome effettivo del protocollo, ad esempio MAPI, file o csc.

Chiave del Registro di sistema Possibili valori Digitare Commenti
HKEY_LOCAL_MACHINE\Software\Microsoft\Windows Search\PHSearchConnectors\<protocollo>\Version Non esiste (impostazione predefinita). In caso contrario, è 1 o superiore. REG_DWORD Questo valore viene usato per rilevare le modifiche apportate alle registrazioni del modello di posizione per le radici di ricerca già elaborate. Se non esiste, usare 0 come valore predefinito. In alternativa, incrementare la versione per informare Esplora Risorse di Windows che il connettore di ricerca deve essere rigenerato perché è stata installata una versione più recente del gestore dei protocolli.
HKEY_LOCAL_MACHINE\Software\Microsoft\Windows Search\PHSearchConnectors\<protocollo>\DoNotCreateSearchConnectors Non esiste (impostazione predefinita). In caso contrario, impostare su 1. REG_DWORD Se non esiste, creare un file searchconnector-ms nella cartella Ricerche. Se 1, contrassegnare come elaborato e non eseguire alcuna operazione.
HKEY_LOCAL_MACHINE\Software\Microsoft\Windows Search\PHSearchConnectors\<protocollo>\Default\Description Stringa localizzabile contenente la descrizione del connettore di ricerca. REG_SZ Opzionale. Viene usato nell'elemento Description del file .searchconnector-ms.
HKEY_LOCAL_MACHINE\Software\Microsoft\Windows Search\PHSearchConnectors\<protocollo>\Default\Name Stringa localizzata per denominare il connettore di ricerca. Usato come nome del file con estensione .searchconnector-ms. REG_SZ Ogni posizione deve avere un nome univoco. In assenza di questo valore, verrà utilizzato il nome visualizzato fornito dall'interfaccia IShellFolder del gestore protocollo .
HKEY_LOCAL_MACHINE\Software\Microsoft\Windows Search\PHSearchConnectors\<protocollo>\Default\FolderType GUID che identifica il FOLDERTYPEID da applicare al connettore di ricerca. REG_SZ Opzionale. Utilizzato nell'elemento folderType del file con estensione searchconnector-ms per indicare quali modelli devono essere usati per visualizzare i risultati. Ad esempio, il valore GUID di FOLDERTYPEID_Documents.

 

Disabilitazione della creazione del connettore di ricerca del gestore del protocollo

Se l'applicazione espone elementi tramite un gestore di protocollo da usare nell'applicazione stessa e non si desidera esporre gli elementi tramite shell (in menu Start e ricerche in Esplora risorse di Windows), è necessario disabilitare la creazione di un connettore di ricerca per il gestore del protocollo.

Per disabilitare la creazione del connettore di ricerca, impostare DoNotCreateSearchConnectors su 0x00000001(1), come illustrato nell'esempio di chiave del Registro di sistema seguente.

HKEY_LOCAL_MACHINE
   Software
      Microsoft
         Windows Search
            PHSearchConnectors
               <protocol>
                  DoNotCreateSearchConnectors

Se DoNotCreateSearchConnectors è impostato su 1, è consigliabile esporre la proprietà System.Shell.OmitFrom View per ogni elemento esposto dal gestore del protocollo e impostare il valore di questa proprietà su TRUE. In questo modo, gli elementi del gestore del protocollo non verranno visualizzati nel gruppo Start del menu File.

Se DoNotCreateSearchConnectors è presente e impostato su zero, Esplora file creerà un connettore di ricerca per il gestore del protocollo e gli elementi del gestore del protocollo verranno restituiti nel menu Start e nelle ricerche in Esplora file.

Personalizzazione del nome, della descrizione o del tipo di cartella per un connettore di ricerca del gestore del protocollo

Il nome del connettore di ricerca viene usato non solo per identificare il connettore di ricerca nella cartella ricerche, ma come intestazione di gruppo per i risultati nelle ricerche di menu Start. Di conseguenza, è importante specificare un nome descrittivo per il connettore di ricerca. Se non viene specificato un nome nella chiave del Registro di sistema, per impostazione predefinita Esplora risorse usa il nome fornito da interfaccia IShellFolder per la radice di ricerca e la descrizione vuota del gestore del protocollo. È possibile eseguire l'override del nome predefinito tramite una voce di chiave del Registro di sistema senza dover rinominare l'interfaccia IShellFolder. Anche se non è altrettanto visibile quanto il nome del connettore di ricerca, è possibile eseguire l'override della descrizione del connettore di ricerca fornendo una descrizione personalizzata.

Per eseguire l'override del nome o della descrizione predefinito, impostare le voci come illustrato nell'esempio seguente del Registro di sistema.

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

Inoltre, la voce FolderType può essere impostata su uno dei GUID FOLDERTYPEID. Il valore deve essere il GUID effettivo e non il nome. Ad esempio, {94d6dcc-4a68-4175-a374-bd584a510b78} anziché FOLDERTYPEID_Music. Il GUID per un FOLDERTYPEID può essere ottenuto nel file header Shlguid.h nel Windows SDK.

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

Uso del reindirizzamento delle stringhe del Registro di sistema

È possibile usare una stringa reindirizzata per assicurarsi che il nome specificato per il connettore di ricerca possa essere localizzato. È possibile includere stringhe localizzabili per le chiavi del Registro di sistema nome e descrizione anziché immettere la stringa effettiva nel Registro di sistema.

Per includere una stringa localizzabile per i valori Name o Description, impostare il valore come illustrato nell'esempio di chiave del Registro di sistema seguente.

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

La stringa localizzabile accetta il formato seguente:

  • @dllname.dll,-resourceID, dove:
    • @dllname.dll è il percorso della DLL che contiene la risorsa stringa
    • resourceID è l'ID risorsa integer della risorsa stringa

Il formato per una stringa indiretta e una stringa indiretta aggiunta con un modificatore di versione, è descritto in funzione SHLoadIndirectString.

Ripristino di un connettore di ricerca del gestore del protocollo eliminato

Poiché i connettori di ricerca sono file nel computer dell'utente, possono essere eliminati erroneamente. Per ripristinare tutti i connettori di ricerca dei gestori di protocolli eliminati, ripristinare le librerie predefinite. A tale scopo, aprire Esplora risorse, fare clic con il pulsante destro del mouse sulla cartella Librerie e quindi selezionare Ripristina librerie predefinite.

screenshot che mostra l'opzione di menu

Risorse aggiuntive

concettuale

Comprensione dei gestori di protocollo

Sviluppo di Gestori di Protocolli

notifica dell'indice delle modifiche

Aggiunta di icone e menu di scelta rapida

esempio di codice : estensioni della shell per i gestori di protocollo

l'installazione e la registrazione dei gestori di protocollo

i gestori del protocollo di debug