ITfFnSearchCandidateProvider::GetSearchCandidates 메서드(ctffunc.h)

IME 관련 메시지 또는 이벤트를 생성하지 않고 지정된 문자열의 변환 후보 목록을 가져옵니다.

구문

HRESULT GetSearchCandidates(
  [in]  BSTR             bstrQuery,
  [in]  BSTR             bstrApplicationId,
  [out] ITfCandidateList **pplist
);

[in] bstrQuery

텍스트 서비스에서 변환하려고 시도하는 읽기 문자열을 지정하는 문자열입니다.

[in] bstrApplicationId

텍스트 서비스가 입력 기록에 따라 다른 앱 또는 컨텍스트에 다른 후보를 선택적으로 제공할 수 있도록 하는 앱 지정 문자열입니다. 일반 컨텍스트에 대해 빈 BSTR L""을 전달할 수 있습니다.

[out] pplist

요청된 후보 데이터를 수신하는 ITfCandidateList 입니다.

이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.

반환 코드	Description
S_OK	메서드를 성공적으로 수행했습니다.
S_FALSE	입력 문자열에 대해 후보를 반환할 수 없습니다. pplist 는 NULL일 수 있습니다.