Создание соединителя поиска для обработчика протокола

Обозреватель Windows управляет созданием соединителя поиска для обработчика протокола с помощью записей раздела реестра. С помощью реестра как разработчики, так и третьи стороны могут включать новые и устаревшие обработчики протоколов для участия в поиске в Windows 7.

Этот раздел организован следующим образом:

• О соединителях поиска для обработчиков протоколов в Windows 7
• Активация обработчиков протоколов для участия в поиске
  • отключение создания поискового соединителя по протоколу
  • Настройка имени, описания или типа папки для функции поиска по протоколу
  • Использование перенаправления строк реестра
  • восстановление соединителя для поиска удаленного обработчика протоколов
• дополнительные ресурсы
• связанные разделы

Сведения о поисковых соединителях для обработчиков протоколов в Windows 7

В Windows 7 поиски из меню Пуск или проводника Windows включают только файлы в индексированных расположениях, а также элементы, которые не принадлежат к файловой системе, такие как удаленные хранилища данных или элементы обработчика протокола, имеющие соединитель поиска. Помимо включения элементов обработчика протокола в сферу охвата Запуск меню и поисков оболочки, коннектор поиска дает возможность меню Пуск группировать элементы обработчика протокола вместе в результатах меню Пуск, позволяя пользователю щелкнуть заголовок группы и просмотреть результаты только обработчика протокола. Кроме того, пользователь может перейти к папке "Searches", открыть файл подключения поиска и выполнить поиск, содержащий только элементы из определенного обработчика протокола, связанного с этим коннектором поиска.

Когда пользователь впервые запускает приложение, которое регистрирует обработчик протокола, Проводник Windows создает файл соединителя поиска (.searchConnector-ms) для обработчика протокола в папке Searches пользователя. Приложения с обработчиками протокола могут отключить это поведение или настроить имя и описание соединителя поиска обработчика протокола.

Обозреватель Windows управляет созданием соединителя поиска для обработчика протокола с помощью записей раздела реестра, описанных в следующих разделах:

• включение обработчиков протоколов для участия в поиске
• Отключение создания соединителя поиска по протоколу
• Настройка имени, описания или FolderType для соединителя поиска по протоколу
• восстановление соединителя поиска удаленного обработчика протокола

Включение обработчиков протоколов для участия в поиске

Ключи реестра и их возможные значения описаны в следующей таблице. Обработчик протокола может заполнить некоторые или все эти разделы реестра, где <протокол> заменен фактическим именем протокола, например MAPI, file или csc.

Отключение создания соединителя поиска обработчика протокола

Если приложение предоставляет элементы с помощью обработчика протокола для использования в самом приложении, и вы не хотите предоставлять элементы через оболочку (в меню запуска и поиска проводника Windows), необходимо отключить создание соединителя поиска для обработчика протокола.

Чтобы отключить создание соединителя поиска, установите для DoNotCreateSearchConnectors значение 0x00000001(1), как показано в следующем примере ключа реестра.

HKEY_LOCAL_MACHINE
   Software
      Microsoft
         Windows Search
            PHSearchConnectors
               <protocol>
                  DoNotCreateSearchConnectors

Если для DoNotCreateSearchConnectors задано значение 1, рекомендуется предоставить свойство System.Shell.OmitFromView для каждого элемента, доступного обработчиком протокола, и задайте для этого свойства значение TRUE. Это позволит предотвратить отображение элементов обработчика протокола в меню "Пуск" в группе "Файлы".

Если DoNotCreateSearchConnectors присутствует и установлено в ноль, проводник Windows создаст коннектор для поиска для обработчика протокола, а элементы обработчика протокола будут возвращены в меню "Пуск" и в результатах поиска проводника Windows.

Настройка имени, описания или типа папки для соединителя поиска обработчика протокола

Имя соединителя поиска используется не только для идентификации соединителя поиска в папке Searches, но и в качестве заголовка группы для результатов поиска в меню Start. Поэтому важно указать описательное имя соединителя поиска. Если имя не указано в разделе реестра, по умолчанию в проводнике Windows используется имя, предоставленное интерфейсом IShellFolder для корневого и пустого описания обработчика протокола. Имя по умолчанию можно переопределить с помощью записи раздела реестра без необходимости переименовать интерфейс IShellFolder. Хотя это не так заметно, как название соединителя поиска, вы можете также изменить определение соединителя поиска, предоставив собственное описание.

Чтобы переопределить имя или описание по умолчанию, задайте записи, как показано в следующем примере реестра.

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

Кроме того, для параметра FolderType можно задать один из идентификаторов GUID FOLDERTYPEID. Значение должно быть фактическим ИДЕНТИФИКАТОРом GUID, а не его именем. Например, {94d6dcc-4a68-4175-a374-bd584a510b78} вместо FOLDERTYPEID_Music. GUID для FOLDERTYPEID можно получить в заголовочном файле Shlguid.h в пакете Windows SDK.

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

Использование перенаправления строк реестра

Вы можете использовать перенаправленную строку , чтобы убедиться, что указанное вами имя для соединителя поиска можно локализовать. Вместо ввода фактической строки в реестр можно использовать локализованные строки для ключей реестра, связанных с именем и описанием.

Чтобы включить локализуемую строку для значений Имя или Описание, задайте значение, как показано в следующем примере раздела реестра.

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

Локализованная строка принимает следующий формат:

• @dllname.dll,-resourceID, где:
  • @dllname.dll — это путь к библиотеке DLL, содержащей строковый ресурс.
  • resourceID — это целочисленный идентификатор ресурса строки.

Формат косвенной строки, а также косвенной строки с добавленным модификатором версии, описаны в функции SHLoadIndirectString.

Восстановление поискового подключаемого модуля для удаленного обработчика протоколов

Так как соединители поиска являются файлами на компьютере пользователя, их можно ошибочно удалить. Чтобы восстановить все удаленные соединители поиска для обработчиков протоколов, восстановите библиотеки по умолчанию. Для этого откройте проводник Windows, щелкните правой кнопкой мыши папку библиотек, а затем выберите восстановить библиотеки по умолчанию.

снимок экрана

Дополнительные ресурсы

• IShellItem::GetDisplayName
• SIGDN_NORMALDISPLAY

Связанные разделы

концептуальные

Основные сведения о обработчиках протоколов

Разработка Обработчиков Протоколов

Уведомление об индексе изменений

добавление значков и контекстных меню

пример кода : расширения оболочки для обработчиков протоколов

установка и регистрация обработчиков протоколов

Обработчики протоколов отладки