Korzystanie z protokołu wyszukiwania

Protokół aplikacji : jest rozszerzalną konwencją wywoływania aplikacji wyszukiwania pulpitu w systemie Windows Vista z dodatkiem Service Pack 1 (SP1) i nowszymi wersjami. Protokół został utworzony w systemie Windows Vista z dodatkiem SP1, aby umożliwić systemowi Windows określenie i wywołanie domyślnej aplikacji wyszukiwania pulpitu.

Składnia protokołu udostępnia wiele parametrów przydatnych do przeprowadzania typowych wyszukiwań pulpitu, takich jak terminy wyszukiwania wprowadzone przez użytkownika lub lokalizacja, w której rozpoczęto wyszukiwanie. Gdy użytkownicy wyszukują jeden z dwóch dostępnych punktów wejścia wyszukiwania (menu Start lub Eksploratora Windows), system operacyjny używa protokołu wyszukiwania do uruchamiania domyślnej aplikacji wyszukiwania pulpitu. Robi to przez dodanie wprowadzonych przez użytkownika terminów wyszukiwania do standardowej składni protokołu wyszukiwania i przekazanie tych informacji do aplikacji zarejestrowanej jako domyślna aplikacja wyszukiwania.

Jeśli nie są zainstalowane żadne inne aplikacje do wyszukiwania pulpitu, wyszukiwanie wprowadzone w tych punktach wejścia uruchamia Eksploratora wyszukiwania Windows. Jednak deweloperzy innych firm mogą tworzyć, instalować i rejestrować swoje aplikacje, aby obsługiwać protokół wyszukiwania i być domyślną aplikacją wyszukiwania. Takie aplikacje muszą obsługiwać składnię protokołu wyszukiwania i rejestrować się za pomocą funkcji Domyślne programy, aby zapewnić bezproblemowe środowisko pracy z systemem Windows.

Jeśli tworzysz aplikację, która ma być używana lub oparta na określonej aplikacji wyszukiwania pulpitu, nie powinieneś polegać wyłącznie na protokole wyszukiwania :. Ponieważ wiele aplikacji może mieć przypisany protokół wyszukiwania :, nie ma gwarancji, że docelowa aplikacja wyszukiwania pulpitu będzie jego właścicielem w danym momencie. Zamiast tego należy użyć protokołu wyszukiwania prywatnego zdefiniowanego przez docelową aplikację wyszukiwania pulpitu. Oznacza to, że aplikacje do wyszukiwania na komputerach, które mają służyć jako platformy dla aplikacji innych firm, powinny obsługiwać zarówno protokół wyszukiwania :, jak i własny zastrzeżony protokół wyszukiwania.

W tym temacie omówiono następujące zagadnienia:

• Składnia
• Windows Vista z dodatkiem SP1 używa protokołu: funkcji wyszukiwania
• Przykłady
• zarejestrowanie aplikacji obsługującej protokołu
  • wpisy rejestru
• Tematy pokrewne

Składnia

Protokół wyszukiwania używa następującej standardowej składni zakodowanej pod adresem URL:

search:parameter=value[&parameter=value]&

Składnia rozpoczyna się od zidentyfikowania samego protokołu (search:). Pary parametrów/wartości są argumentami przekazywanymi do wyszukiwarki, zgodnie z opisem w poniższej tabeli, w której przedstawiono wszystkie możliwe parametry składni protokołu wyszukiwania.

System Windows Vista z dodatkiem SP1 używa protokołu wyszukiwania.

System Windows Vista z dodatkiem SP1 ma kilka punktów wejścia, z których wywołuje protokół wyszukiwania :. Te punkty wejścia są opisane poniżej, a także typowa składnia skojarzona z każdym z nich.

Punkty wejścia protokołu wyszukiwania systemu Windows Vista z dodatkiem SP1 nie korzystają ze wszystkich możliwych parametrów w protokole wyszukiwania. Aplikacje, które dotyczą tylko obsługi wywołań protokołu wyszukiwania z systemu Windows Vista z dodatkiem SP1, mogą użyć poniższej tabeli jako przewodnika do minimum, które muszą zaimplementować.

Przykłady

Jeśli użytkownik wprowadzi ciąg "Microsoft" w menu Start i kliknie opcję Szukaj wszędzie, zostanie wykonane odpowiednie wywołanie protokołu wyszukiwania.

search:query=microsoft&

Jeśli użytkownik wprowadzi ciąg "Seattle" w Eksploratorze Windows w folderze C:\MyFolder, a następnie kliknie Wyszukaj wszędzie, zostanie wykonane następujące wywołanie, używając znaków ucieczki dla ":" i "\":

search:query=seattle&crumb=location:C%3A%5CMyFolder

Rejestrowanie aplikacji obsługującej protokół

Podczas instalacji należy zarejestrować aplikację w funkcji Domyślne Programy, ponieważ wiele aplikacji może rywalizować o protokół wyszukiwania, co umożliwi użytkownikowi łatwiejsze skonfigurowanie ustawień domyślnych. Oprócz procedur instalacji zwykle praktykowanych w systemie Windows XP aplikacja oparta na systemie Windows Vista musi zarejestrować się za pomocą funkcji Programy domyślne, aby aplikacja i użytkownicy mogli bezproblemowo skonfigurować ustawienia domyślne.

Po zainstalowaniu niezbędnych plików binarnych na komputerze użytkownika procedura instalacji powinna wykonać następujące ogólne zadania:

1. Zapisz ProgID-y w HKEY_LOCAL_MACHINE, zgodnie z poniższym opisem. Należy pamiętać, że aplikacje muszą tworzyć identyfikatory ProgID specyficzne dla aplikacji dla protokołu wyszukiwania.
2. Żądanie skojarzenia z protokołem wyszukiwania na poziomie maszyny.
3. Zarejestruj aplikację w Programach domyślnych, zgodnie z opisem w Rejestrowanie aplikacji do użycia z Programami domyślnymi, jako kandydat do protokołu wyszukiwania.

Wpisy rejestru

Poniżej przedstawiono przykłady wymaganych wpisów rejestru dla fikcyjnej aplikacji do wyszukiwania na pulpicie, Contoso Search.

HKEY_LOCAL_MACHINE
   SOFTWARE
      Classes
         contoso-search
            URL Protocol = ""

HKEY_LOCAL_MACHINE
   SOFTWARE
      Classes
         contoso-search
            DefaultIcon
               (Default) = %ProgramFiles%\Contoso\Search\contososearch.exe,-7

HKEY_LOCAL_MACHINE
   SOFTWARE
      Classes
         contoso-search
            shell
               open
                  command
                     (Default) = %ProgramFiles%\Contoso\Search\contososearch.exe %1

HKEY_LOCAL_MACHINE
   SOFTWARE
      RegisteredApplications
         Contoso Search = "Software\\Contoso\\Search\\Capabilities"

HKEY_LOCAL_MACHINE
   SOFTWARE
      Contoso
         Search
            Capabilities
               ApplicationName = "Contoso Search Test App"
               ApplicationDescription = "Contoso search is a great new desktop search application"

HKEY_LOCAL_MACHINE
   SOFTWARE
      Contoso
         Search
            Capabilities
               UrlAssociations
                  search = "contoso-search"

Tematy pokrewne

Zaawansowana składnia zapytań

Programy domyślne