通过

搜索连接器说明架构

  • 项目

介绍 Windows 资源管理器库和联合搜索提供程序使用的搜索连接器说明架构。 该架构指定搜索连接器说明文件（*.searchConnector-ms）的结构和要求，以及 searchConnectorDescriptionType Shell 库说明 （*.library-ms） 文件的元素。

本主题介绍架构，因为它与联合搜索连接器相关。 有关库和库说明架构的详细信息，请参阅 库说明架构。

本主题包含以下部分：

什么是搜索连接器？

搜索连接器将用户连接到存储在 Web 服务或远程存储位置中的数据。 使用 Windows 7，用户可以为位置（如 Web 服务）安装搜索连接器，以便他们直接从 Windows 资源管理器搜索这些位置。 搜索连接器是搜索连接器说明文件（*.searchConnector-ms），用于指定如何连接到、向其发送查询以及从位置接收结果。

除了 Web 服务，搜索连接器还可用于搜索协议处理程序创建的本地索引范围。 例如，用户可以使用该电子邮件存储的搜索连接器搜索使用 MAPI 协议处理程序在本地编制索引的电子邮件。

搜索连接器说明文件的工作原理是什么？

在用户系统上安装搜索连接器说明文件时，用户可以打开 Windows 资源管理器，在导航窗格中单击搜索连接器，然后输入搜索查询。 Windows 资源管理器使用搜索连接器说明文件中的信息（例如要使用的提供程序和搜索范围）发送查询。 结果以 RSS 或 Atom 源项的形式返回，并向用户显示，就像它们是常规 Shell 项一样。

部署搜索连接器说明文件的方式取决于搜索连接器支持的位置类型：

  • 在 Web 服务的 OpenSearch 配置 （*.osdx） 文件中
  • 作为协议处理程序安装的一部分

用户打开 .osdx 文件或安装协议处理程序时，应确保发生以下情况：

  • .searchconnector-ms 文件是在用户的 Windows 搜索 文件夹（%userprofile%/Search）中创建的。
  • 在用户的 链接 文件夹（%userprofile%/Links）中创建 .searchconnector-ms 文件的快捷方式。

什么是搜索连接器说明架构？

搜索连接器描述架构是一种 XML 架构，用于定义搜索连接器说明文件（*.searchConnector-ms）的结构。 每个搜索连接器都必须有一个搜索连接器说明文件，该文件指定如何连接到、向位置发送查询以及从位置接收结果。

架构的主要部分是什么？

下表列出了架构的主要部分。

子元素 描述
isSearchOnlyItem 标识搜索连接器支持的位置是仅搜索还是搜索和浏览。
isDefaultSaveLocation 仅用于库。
isDefaultNonOwnerSaveLocation 仅用于库。
说明 描述搜索连接器。
iconReference 标识搜索连接器的自定义图标的位置。
imageLink 标识搜索连接器的自定义缩略图的位置。
作者 标识搜索连接器的作者。
dateCreated 标识创建搜索连接器的日期。
templateInfo 指定搜索连接器的文件夹类型。
locationProvider 指定此搜索连接器要使用的搜索提供程序。
范围 指定要包含在搜索范围中和从搜索范围中排除的位置。
propertyStore 指定此搜索连接器的基于 XML 的 IPropertyStore 的位置。 IPropertyStore 支持搜索连接器的打开元数据。
includeInStartMenuScope 指定搜索连接器所表示的位置是否应包含在“开始”菜单的搜索范围中。
域 标识搜索连接器的顶级域。
支持AdvancedQuerySyntax 指定搜索连接器是否支持高级查询语法（AQS）。
isIndexed 指定搜索连接器所表示的位置是否编制索引。

 

搜索连接器说明文件的示例

下面是联合搜索 Web 服务的搜索连接器说明文件的示例。

<?xml version="1.0" encoding="UTF-8"?>
<searchConnectorDescription xmlns="http://schemas.microsoft.com/windows/2009/searchConnector">
  <description>Search powered by live.com</description>
  <isSearchOnlyItem>true</isSearchOnlyItem>
  <domain>https://social.msdn.microsoft.com</domain>
  <supportsAdvancedQuerySyntax>false</supportsAdvancedQuerySyntax>
  <templateInfo>
    <folderType>{8FAF9629-1980-46FF-8023-9DCEAB9C3EE3}</folderType>
  </templateInfo>
  <propertyStore>
    <property name="OpenSearchHTMLRolloverTemplate">https://social.msdn.microsoft.com/Search/?Query={searchTerms}</property>
  </propertyStore>
  <locationProvider clsid="{48E277F6-4E74-4cd6-BA6F-FA4F42898223}">
    <propertyBag>
      <property name="OpenSearchShortName">MSDN</property>
      <property name="OpenSearchQueryTemplate">https://social.msdn.microsoft.com/Search/Feed.aspx?locale=en-US&Query={searchTerms}&format=RSS&StartIndex={startIndex}</property>
      <property name="MaximumResultCount" type="uint32">100</property>
    </propertyBag>
  </locationProvider>
</searchConnectorDescription>

下面是 MAPI 协议处理程序的搜索连接器说明文件的示例。

<?xml version="1.0" encoding="UTF-8"?>
<searchConnectorDescription xmlns="http://schemas.microsoft.com/windows/2009/searchConnector">
    <description>Microsoft Outlook</description>
    <isSearchOnlyItem>true</isSearchOnlyItem>
    <includeInStartMenuScope>true</includeInStartMenuScope>
    <templateInfo>
        <folderType>{91475FE5-586B-4EBA-8D75-D17434B8CDF6}</folderType>
    </templateInfo>
    <simpleLocation>
        <url>mapi://{S-1-5-21-2127521184-1604012920-1887927527-2779359}/</url>
    </simpleLocation>
</searchConnectorDescription>

其他资源

  • 有关库说明架构的详细信息，请参阅 库说明架构。
  • 有关安装搜索连接器的详细信息，请参阅 Windows 中的联合搜索。

参考

searchConnectorDescriptionType 元素（搜索连接器架构）

其他资源

OpenSearch

Microsoft 下载中心