ISearchCatalogManager2::P rioritizeMatchingURLs 方法 (searchapi.h)

指示索引器为具有与指定模式匹配的 URL 的索引项提供更高的优先级。 然后,这些项的优先级将高于其他索引任务。

语法

HRESULT PrioritizeMatchingURLs(
  [in] LPCWSTR          pszPattern,
  [in] PRIORITIZE_FLAGS dwPrioritizeFlags
);

参数

[in] pszPattern

类型: LPCWSTR

一个指定 URL 模式的字符串,该模式定义索引编制失败且需要重新编制索引的项。

[in] dwPrioritizeFlags

类型: PRIORITIZE_FLAGS

PRIORITIZE_FLAGS 枚举中的值,该值指定如何处理索引器未能编制索引的项。

返回值

类型: HRESULT

如果成功,则返回 S_OK,否则返回错误值。

注解

pszPattern 字符串必须指定与整个项 URL 匹配的模式。 可以使用星号通配符创建模式字符串。

PRIORITIZE_FLAG_IGNOREFAILURECOUNT标志仅与 PRIORITIZE_FLAG_RETRYFAILEDITEMS 标志结合使用。

示例

以下示例演示如何使用星号通配符和 PRIORITIZE_FLAG_IGNOREFAILURECOUNT

hr = cpSearchCatalogManager2->PrioritizeMatchingURLs("mapi://{<SID>}/Mailbox - Boyer Zara/*",
            PRIORITIZE_FLAG_RETRYFAILEDITEMS);
hr = cpSearchCatalogManager2->PrioritizeMatchingURLs("file:f:/Project Files/*",
            PRIORITIZE_FLAG_RETRYFAILEDITEMS);
hr = cpSearchCatalogManager2->PrioritizeMatchingURLs("file:f:/Project Files/*.docx",
            PRIORITIZE_FLAG_RETRYFAILEDITEMS | PRIORITIZE_FLAG_IGNOREFAILURECOUNT);

要求

要求
最低受支持的客户端 带 SP2 的 Windows XP、带 SP2 的 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 SP1 [仅限桌面应用]
目标平台 Windows
标头 searchapi.h
可再发行组件 Windows 搜索 (WS) 4.0