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);

요구 사항

요구 사항	값
지원되는 최소 클라이언트	WINDOWS XP SP2, Windows Vista SP2 포함 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 SP1 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	searchapi.h
재배포 가능 파일	WS(Windows Search) 4.0