다음을 통해 공유


검색 프로토콜 사용

검색: 애플리케이션 프로토콜은 WINDOWS Vista에서 SP1(서비스 팩 1) 이상 버전을 사용하여 데스크톱 검색 애플리케이션을 호출하기 위한 확장 가능한 규칙입니다. 이 프로토콜은 Windows에서 기본 데스크톱 검색 애플리케이션을 확인하고 호출할 수 있는 방법을 제공하기 위해 WINDOWS Vista에서 SP1을 사용하여 만들어졌습니다.

프로토콜 구문은 사용자가 입력한 검색어 또는 검색이 시작된 위치와 같은 일반적인 데스크톱 검색을 수행하는 데 유용한 여러 매개 변수를 제공합니다. 사용자가 사용 가능한 두 검색 진입점( 시작 메뉴 또는 Windows 탐색기) 중 하나에서 검색하는 경우 운영 체제는 검색 프로토콜을 사용하여 기본 데스크톱 검색 애플리케이션을 시작합니다. 이렇게 하려면 사용자가 입력한 검색어를 표준 검색 프로토콜 구문에 추가하고 해당 정보를 기본 검색 애플리케이션으로 등록된 애플리케이션에 전달합니다.

다른 데스크톱 검색 응용 프로그램이 설치되어 있지 않으면 이러한 진입점에 입력된 검색이 Windows 검색 탐색기를 시작합니다. 그러나 타사 개발자는 검색 프로토콜을 처리하고 기본 검색 애플리케이션이 되기 위해 애플리케이션을 만들고 설치하고 등록할 수 있습니다. 이러한 애플리케이션은 Windows에서 원활한 환경을 보장하기 위해 검색 프로토콜 구문을 지원하고 기본 프로그램 기능에 등록해야 합니다.

특정 데스크톱 검색 애플리케이션을 사용하거나 빌드하기 위한 애플리케이션을 개발하는 경우 검색 프로토콜만 의존해서는 안 됩니다. 많은 애플리케이션이 검색: 프로토콜을 소유할 수 있으므로 지정된 시간에 대상 데스크톱 검색 애플리케이션이 해당 애플리케이션을 소유할 것이라는 보장은 없습니다. 대신 대상 데스크톱 검색 애플리케이션에서 정의한 프라이빗 검색 프로토콜을 사용해야 합니다. 즉, 타사 애플리케이션을 위한 플랫폼이 되도록 의도된 데스크톱 검색 애플리케이션은 검색( 프로토콜 및 자체 소유 검색 프로토콜)을 모두 지원해야 합니다.

참고 항목

검색: 프로토콜은 독점 search-ms: 프로토콜을 대체하지 않습니다. 애플리케이션은 여전히 search-ms: 프로토콜을 사용하여 창 검색 탐색기를 시작하거나 Windows Search 인덱서를 자동으로 쿼리할 수 있습니다.

 

이 항목에서는 다음에 대해 설명합니다.

구문

검색 프로토콜은 다음 표준 URL로 인코딩된 구문을 사용합니다.

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

구문은 프로토콜 자체를 식별하는 것으로 시작합니다(검색:). 매개 변수/값 쌍은 다음 표에 설명된 대로 검색 엔진에 전달되는 인수로, 검색 프로토콜 구문에 대해 가능한 모든 매개 변수를 보여 줍니다.

매개 변수 설명
query URL로 인코딩된 텍스트 사용자가 입력한 쿼리 텍스트입니다.
inputlocale 유효한 언어 코드 식별자(LCID) 쿼리의 입력 언어를 식별하는 LCID입니다.
keywordlocale 유효한 모든 LCID 국제 버전의 인덱서 언어를 식별하는 LCID입니다. 기본값은 1033(en-us)입니다.
빵 부스러기 AQS 문 이 인수는 검색되는 범위를 제한합니다. Windows Vista에서 검색 프로토콜은 인수에 대한 특수 구현뿐만 아니라 전체 AQS를 location 지원합니다. Windows XP에서 검색 프로토콜은 특수 구현 kindstore을 제외하고 전체 AQS도 지원합니다.
통사론 NQS, AQS(대/소문자 구분 안 함) 인덱스를 검색하는 데 사용할 쿼리 구문입니다. 자연 쿼리 구문 또는 AQS(고급 쿼리 구문). AQS는 기본값이며 항상 구문 분석되고 지원되는 것으로 간주됩니다.
stackedby 속성 시스템의 유효한 속성 결과를 쌓을 열을 지정하는 속성입니다.
subquery 저장된 검색 파일의 완전히 지정된 경로(*.search-ms) 하위 쿼리의 결과는 쿼리의 원본으로 사용됩니다. 즉, 쿼리 용어는 하위 쿼리의 결과에 대해 검색됩니다.
displayname URL로 인코딩된 문자열 현재 검색의 이름입니다.

 

검색을 SP1로 사용하는 Windows Vista: 프로토콜

WINDOWS Vista SP1에는 검색을 호출하는 몇 가지 진입점인 프로토콜이 있습니다. 이러한 진입점은 아래에 설명되어 있으며 각 항목과 연결된 일반적인 구문도 설명되어 있습니다.

프로토콜 진입점 검색 위치 호출된 쿼리
모든 곳에서 검색 시작 메뉴 search:query=<Search Term>
모든 곳에서 검색 Windows 탐색기 search:query=<Search Term>&crumb=location:<LOCATION>
Windows 로고 키+F 원하는 위치 검색:
Ctrl+F Windows 탐색기 search:query=<Search Term>&crumb=location:<LOCATION>
F3 시작 메뉴 검색:
F3 Windows 탐색기 search:query=<Search Term>&crumb=location:<LOCATION>

 

SP1 검색 프로토콜 진입점이 있는 Windows Vista는 검색 프로토콜에서 가능한 모든 매개 변수를 활용하지 않습니다. SP1을 사용하여 Windows Vista에서 검색 프로토콜 호출을 처리하는 데만 관련된 애플리케이션은 다음 표를 구현하는 데 필요한 최소값에 대한 지침으로 사용할 수 있습니다.

매개 변수 Windows에서 사용하시겠습니까? 검색을 호출할 때 SP1이 있는 Windows Vista에서 사용하는 방법:
query 사용자가 입력한 쿼리 텍스트입니다.
빵 부스러기 crumb 는 인수를 location 사용하여 쿼리의 원본 위치를 지정합니다.
subquery 하위 쿼리 인수의 결과는 검색할 항목의 범위로 사용됩니다. 이는 일반적으로 사용자가 .search-ms 파일을 사용하여 검색한 다음 해당 검색 내에서 기본 데스크톱 검색 애플리케이션을 호출하는 경우에 사용됩니다.
inputlocale 아니요 현재 사용되지 않습니다.
keywordlocale 아니요 현재 사용되지 않습니다.
통사론 아니요 현재 사용되지 않습니다.
stackedby 아니요 현재 사용되지 않습니다.
displayname 아니요 현재 사용되지 않습니다.

 

예제

사용자가 시작 메뉴에서 "Microsoft"를 입력하고 모든 곳에서 검색을 클릭하면 결과 검색 프로토콜 호출이 수행됩니다.

search:query=microsoft&

사용자가 C:\MyFolder 내의 Windows 탐색기에서 "Seattle"을 입력한 다음 모든 곳에서 검색을 클릭하면 ':' 및 '\'에 대한 이스케이프 문자를 사용하여 다음 호출이 수행됩니다.

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

프로토콜을 처리하는 애플리케이션 등록

여러 애플리케이션이 검색 프로토콜에 대해 경합할 수 있으므로 사용자가 기본값을 보다 쉽게 구성할 수 있도록 설치하는 동안 애플리케이션을 기본 프로그램 기능에 등록해야 합니다. Windows XP에서 일반적으로 실행되는 설치 절차 외에도 Windows Vista 기반 애플리케이션은 기본 프로그램 기능에 등록해야 애플리케이션과 사용자가 기본값을 원활하게 구성할 수 있습니다.

사용자의 컴퓨터에 필요한 이진 파일을 설치한 후 설치 루틴은 다음과 같은 일반적인 작업을 완료해야 합니다.

  1. 아래 설명된 대로 progID를 HKEY_LOCAL_MACHINE 작성합니다. 애플리케이션은 검색 프로토콜에 대한 애플리케이션별 ProgID를 만들어야 합니다.
  2. 클레임 컴퓨터 수준 검색 프로토콜 연결입니다.
  3. 기본 프로그램에 사용할 애플리케이션 등록에 설명된 대로 기본 프로그램에 애플리케이션을 검색 프로토콜의 경쟁자로 등록합니다.

레지스트리 항목

다음은 가상의 데스크톱 검색 애플리케이션인 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"

고급 쿼리 구문

기본 프로그램