ISearchQueryHelper 인터페이스(searchapi.h)

사용자 입력에서 쿼리를 빌드하고, 쿼리를 Windows Search SQL로 변환하고, 창 검색 인덱스로의 연결을 초기화하는 연결 문자열 가져오는 메서드를 제공합니다.

상속

ISearchQueryHelper 인터페이스는 IUnknown 인터페이스에서 상속됩니다. ISearchQueryHelper 에는 다음과 같은 유형의 멤버도 있습니다.

메서드

ISearchQueryHelper 인터페이스에는 이러한 메서드가 있습니다.

ISearchQueryHelper::GenerateSQLFromUserQuery AQS(고급 쿼리 구문) 또는 NQS(자연 쿼리 구문)로 표현된 클라이언트 제공 쿼리 문자열을 기반으로 SQL(구조적 쿼리 언어) 쿼리를 생성합니다.
ISearchQueryHelper::get_ConnectionString 창 검색 인덱스용 OLE DB 연결 문자열 반환합니다.
ISearchQueryHelper::get_QueryContentLocale 쿼리에 대한 LCID(언어 코드 식별자)를 가져옵니다.
ISearchQueryHelper::get_QueryContentProperties 검색 용어가 속성을 명시적으로 지정하지 않는 경우 쿼리에 포함된 속성 목록을 가져옵니다.
ISearchQueryHelper::get_QueryKeywordLocale AQS(고급 쿼리 구문) 키워드를 구문 분석할 때 사용할 로캘의 언어 코드 식별자(LCID)를 가져옵니다.
ISearchQueryHelper::get_QueryMaxResults 쿼리에서 반환할 최대 결과 수를 가져옵니다.
ISearchQueryHelper::get_QuerySelectColumns 쿼리의 SELECT 문에서 요청된 열(또는 속성)을 가져옵니다.
ISearchQueryHelper::get_QuerySorting 쿼리 결과 집합의 정렬 순서를 가져옵니다.
ISearchQueryHelper::get_QuerySyntax 쿼리의 구문을 가져옵니다.
ISearchQueryHelper::get_QueryTermExpansion 쿼리 용어를 확장하는 방법을 지정하는 값을 가져옵니다.
ISearchQueryHelper::get_QueryWhereRestrictions WHERE 절의 쿼리에 추가된 제한을 가져옵니다.
ISearchQueryHelper::p ut_QueryContentLocale 쿼리의 LCID(언어 코드 식별자)를 설정합니다.
ISearchQueryHelper::p ut_QueryContentProperties 검색 용어가 속성을 명시적으로 지정하지 않는 경우 쿼리에 포함할 속성을 설정합니다.
ISearchQueryHelper::p ut_QueryKeywordLocale AQS(고급 쿼리 구문) 키워드를 구문 분석할 때 사용할 로캘의 LCID(언어 코드 식별자)를 설정합니다.
ISearchQueryHelper::p ut_QueryMaxResults 쿼리에서 반환할 최대 결과 수를 설정합니다.
ISearchQueryHelper::p ut_QuerySelectColumns select 문에서 요청된 열(또는 속성)을 설정합니다.
ISearchQueryHelper::p ut_QuerySorting 쿼리 결과 집합의 정렬 순서를 설정합니다.
ISearchQueryHelper::p ut_QuerySyntax 쿼리의 구문을 설정합니다.
ISearchQueryHelper::p ut_QueryTermExpansion 쿼리 용어를 확장하는 방법을 지정하는 값을 설정합니다.
ISearchQueryHelper::p ut_QueryWhereRestrictions WHERE 절의 쿼리에 추가된 제한을 설정합니다.
ISearchQueryHelper::WriteProperties 구현되지 않았습니다. (ISearchQueryHelper.WriteProperties)

설명

이 인터페이스는 ISearchCatalogManager::GetQueryHelper를 호출하여 가져옵니다. ISearchCatalogManager에 대한 도우미 클래스로 이 인터페이스를 구현합니다.

이 인터페이스는 AQS(고급 쿼리 구문) 또는 NQS(자연 쿼리 구문)를 사용하여 SQL 쿼리를 쉽게 생성할 수 있도록 합니다. 클라이언트는 OLE DB 또는 Microsoft ADO(ActiveX Data Objects)를 사용하여 WINDOWS 검색 엔진에 SQL 쿼리를 제출할 수 있습니다.

ISearchQueryHelper::GenerateSQLFromUserQuery 는 지역 로캘 설정을 사용합니다. 그러나 ISearchQueryHelper 는 지역 로캘 설정을 사용하지 않습니다. 따라서 날짜 형식과 같은 지역별 설정에 대해 ISearchQueryHelper::GenerateSQLFromUserQuery 및 ISearchQueryHelper 에서 반환된 SQL의 불일치가 있습니다.

ISearchQueryHelper용 Microsoft.Search.Interop 어셈블리를 사용하여 Windows Search를 쿼리하는 정적 콘솔 애플리케이션에 대한 클래스를 만드는 방법을 보여 주는 샘플은 DSearch 샘플을 참조하세요.

요구 사항

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

추가 정보

프로그래밍 방식으로 인덱스 쿼리

Windows Search SQL 구문을 사용하여 인덱스 쿼리