структура MAPPING_OPTIONS (elscore.h)

Содержит параметры для распознавания текста. Значения, хранящиеся в этой структуре, влияют на поведение и результаты MappingRecognizeText.

Синтаксис

typedef struct _MAPPING_OPTIONS {
  size_t                  Size;
  LPWSTR                  pszInputLanguage;
  LPWSTR                  pszOutputLanguage;
  LPWSTR                  pszInputScript;
  LPWSTR                  pszOutputScript;
  LPWSTR                  pszInputContentType;
  LPWSTR                  pszOutputContentType;
  LPWSTR                  pszUILanguage;
  PFN_MAPPINGCALLBACKPROC pfnRecognizeCallback;
  LPVOID                  pRecognizeCallerData;
  DWORD                   dwRecognizeCallerDataSize;
  PFN_MAPPINGCALLBACKPROC pfnActionCallback;
  LPVOID                  pActionCallerData;
  DWORD                   dwActionCallerDataSize;
  DWORD                   dwServiceFlag;
  unsigned                GetActionDisplayName : 1;
} MAPPING_OPTIONS, *PMAPPING_OPTIONS;

Члены

Size

Размер структуры, используемой для проверки версии структуры. Это значение обязательно.

pszInputLanguage

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

pszOutputLanguage

Необязательный элемент. Указатель на строку языка вывода в соответствии с соглашением об именовании IETF, которая определяет язык вывода, который служба должна использовать для получения результатов. Приложение может присвоить этому члену значение NULL , если служба должна выбрать язык вывода.

pszInputScript

Необязательный элемент. Указатель на стандартное имя скрипта Юникода, которое должно быть принято службой. Приложение может присвоить этому члену значение NULL , чтобы позволить службе решить, как обрабатывать входные данные.

pszOutputScript

Необязательный элемент. Указатель на стандартное имя скрипта Юникода, которое служба должна использовать для получения результатов. Приложение может присвоить этому члену значение NULL , чтобы позволить службе выбрать выходной скрипт.

pszInputContentType

Необязательный элемент. Указатель на строку в соответствии с форматом типов контента MIME, которая определяет формат, который служба должна интерпретировать при передачи данных приложением. Примеры типов контента: "text/plain", "text/html" и "text/css". Приложение может присвоить этому элементу значение NULL , чтобы указать тип контента "text/plain".

Примечание В Windows 7 службы ELS поддерживают только тип контента text/plain. Спецификацию типов контента можно найти в разделе Типы текстовых носителей.

 

pszOutputContentType

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

pszUILanguage

Зарезервировано.

pfnRecognizeCallback

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

pRecognizeCallerData

Необязательный элемент. Указатель на частные данные приложения, передаваемые в функцию обратного вызова службой после завершения распознавания текста. Приложение должно присвоить этому члену значение NULL , чтобы указать отсутствие данных частного приложения.

dwRecognizeCallerDataSize

Необязательный элемент. Размер (в байтах) любых данных частного приложения, указанных элементом pRecognizeCallerData .

pfnActionCallback

Зарезервировано.

pActionCallerData

Зарезервировано.

dwActionCallerDataSize

Зарезервировано.

dwServiceFlag

Необязательный элемент. Частный флаг, который определяет поставщик услуг, чтобы повлиять на поведение службы. Службы могут интерпретировать этот флаг по мере необходимости.

Примечание В Windows 7 ни одна из доступных служб ELS не поддерживает флаги.

 

GetActionDisplayName

Зарезервировано.

Комментарии

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

Предупреждение Данные, передаваемые в этой структуре в MappingRecognizeText, а также данные, на которые ссылается аргумент pszText в этом вызове,

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

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

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

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

 

Требования

Минимальная версия клиента	Windows 7 [классические приложения | Приложения UWP]
Минимальная версия сервера	Windows Server 2008 R2 [классические приложения | Приложения UWP]
Верхняя часть	elscore.h

См. также раздел

Расширенные структуры лингвистических служб

MAPPING_DATA_RANGE

MappingRecognizeText