다음을 통해 공유


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::GenerateSQLFromUserQueryISearchQueryHelper 에서 반환된 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 구문을 사용하여 인덱스 쿼리