다음을 통해 공유

GetBestResultString 함수(recapis.h)

  • 아티클

최상의 결과 문자열을 검색합니다.

구문

HRESULT GetBestResultString(
  HRECOCONTEXT hrc,
  ULONG        *pcSize,
  WCHAR        *pwcBestResult
);

매개 변수

hrc

인식기 컨텍스트에 대한 핸들입니다.

pcSize

입력에서 pwcBestResult 버퍼가 보유할 수 있는 문자 수입니다. 출력에서 pwcBestResult 버퍼에 포함된 문자 수입니다. pwcBestResult가 NULL인 경우 함수는 pwcBestResult 버퍼를 할당하는 데 사용하는 버퍼의 필요한 크기를 반환합니다.

pwcBestResult

인식 결과입니다. 버퍼가 너무 작으면 함수는 문자열을 자립니다. 문자열이 NULL로 종료되지 않았습니다. 버퍼의 필요한 크기를 확인하려면 pwcBestResult 를 NULL로 설정합니다. pcSize 를 사용하여 pwcBestResult 버퍼를 할당합니다.

반환 값

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

반환 코드 Description
S_OK
 성공.

라틴어 및 동아시아 인식자의 경우 pwcBestResult 의 빈 문자열과 함께 이 결과는 인식 결과가 없음을 의미합니다.
TPC_S_TRUNCATED
 문자열이 pwcBestResult 버퍼에 맞게 잘립니다.
E_POINTER
 매개 변수 중 하나가 잘못된 포인터입니다.
E_FAIL
 지정되지 않은 오류가 발생했습니다.
E_INVALIDARG
 잘못된 인수가 수신되었습니다.
E_UNEXPECTED
 예기치 않은 매개 변수 또는 속성 형식입니다.
TPC_E_NOT_RELEVANT
 인식기 컨텍스트에 결과가 포함되어 있지 않습니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows XP 태블릿 PC 버전 [데스크톱 앱 | UWP 앱]
지원되는 최소 서버 지원되는 버전 없음
대상 플랫폼 Windows
헤더 recapis.h
DLL inkobjcore.dll