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