Поделиться через

Функция GetBestResultString (recapis.h)

  • Статья

Извлекает строку наилучшего результата.

Синтаксис

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

Параметры

hrc

Дескриптор контекста распознавателя.

pcSize

На входных данных — количество символов, которые может содержать буфер pwcBestResult . В выходных данных — количество символов, содержащихся в буфере pwcBestResult . Если pwcBestResult имеет значение NULL, функция возвращает необходимый размер буфера, который используется для выделения буфера pwcBestResult .

pwcBestResult

Результат распознавания. Если буфер слишком мал, функция усекает строку. Строка не заканчивается null. Чтобы определить требуемый размер буфера, задайте для pwcBestResult значение NULL; используйте pcSize для выделения буфера pwcBestResult .

Возвращаемое значение

Эта функция может возвращать одно из этих значений.

Код возврата Описание
S_OK
 Успешно.

Для распознавателей латиницы и восточноазиатских языков этот результат в сочетании с пустой строкой в pwcBestResult означает, что результат распознавания не существует.
TPC_S_TRUNCATED
 Строка усекается, чтобы поместиться в буфер pwcBestResult .
E_POINTER
 Один из параметров является недопустимым указателем.
E_FAIL
 Произошла неизвестная ошибка.
E_INVALIDARG
 Получен недопустимый аргумент.
E_UNEXPECTED
 Непредвиденный тип параметра или свойства.
TPC_E_NOT_RELEVANT
 Контекст распознавателя не содержит результатов.

Требования

Требование Значение
Минимальная версия клиента Windows XP Tablet PC Edition [классические приложения | Приложения UWP]
Минимальная версия сервера Ни одна версия не поддерживается
Целевая платформа Windows
Header recapis.h
DLL inkobjcore.dll