Функция MappingRecognizeText (elscore.h)

Статья
08/23/2023

Вызывает службу ELS для распознавания текста. Например, служба распознавания языка (Майкрософт) попытается распознать язык, на котором написан входной текст.

Синтаксис

HRESULT MappingRecognizeText(
  [in]           PMAPPING_SERVICE_INFO pServiceInfo,
  [in]           LPCWSTR               pszText,
  [in]           DWORD                 dwLength,
  [in]           DWORD                 dwIndex,
  [in, optional] PMAPPING_OPTIONS      pOptions,
  [in, out]      PMAPPING_PROPERTY_BAG pbag
);

Параметры

[in] pServiceInfo

Указатель на структуру MAPPING_SERVICE_INFO , содержащую сведения о службе, используемой для распознавания текста. Структура должна быть одной из структур, полученных при предыдущем вызове MappingGetServices. Этот параметр не может иметь значение NULL.

[in] pszText

Указатель на текст для распознавания. Текст должен быть UTF-16, но некоторые службы предъявляют дополнительные требования к формату ввода. Этот параметр не может иметь значение NULL.

[in] dwLength

Длина текста, указанного в pszText, в символах.

[in] dwIndex

Индекс внутри указанного текста, используемого службой. Это значение должно находиться в диапазоне от 0 до dwLength-1. Если приложение хочет обработать весь текст, оно должно задать для этого параметра значение 0.

[in, optional] pOptions

Указатель на структуру MAPPING_OPTIONS , содержащую параметры, влияющие на результат и поведение распознавания текста. Приложению не нужно указывать значения для всех элементов структуры. Для этого параметра можно задать значение NULL , чтобы использовать параметры сопоставления по умолчанию.

[in, out] pbag

Указатель на MAPPING_PROPERTY_BAG структуру, в которой служба хранит свои результаты. При входе приложение передает структуру только с указанным размером, а остальные члены — равным 0. В выходных данных структура заполняется сведениями, создаваемыми службой во время распознавания текста. Этот параметр не может иметь значение NULL.

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

В случае успешного выполнения возвращает S_OK. Функция возвращает значение HRESULT ошибки, если не удалось.

Предупреждение Данные, на которые ссылаются pszText и pOptions, должны оставаться действительными до тех пор, пока структура контейнера свойств, переданная pBag , не будет освобождена через

MappingFreePropertyBag. Это связано с тем, что синхронные и асинхронные вызовы

MappingRecognizeText и MappingDoAction попытаются использовать данные, переданные в начальную

вызов метода MappingRecognizeText.

Требования


Минимальная версия клиента	Windows 7 [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows Server 2008 R2 [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	elscore.h
Библиотека	Elscore.lib
DLL	Elscore.dll