estructura MAPPING_OPTIONS (elscore.h)

Contiene opciones para el reconocimiento de texto. Los valores almacenados en esta estructura afectan al comportamiento y los resultados de MappingRecognizeText.

Sintaxis

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;

Miembros

Size

Tamaño de la estructura, que se usa para validar la versión de la estructura. Este valor es necesario.

pszInputLanguage

Opcional. Puntero a una cadena de idioma de entrada, siguiendo la convención de nomenclatura de IETF, que identifica el idioma de entrada que el servicio debe ser capaz de aceptar. La aplicación puede establecer este miembro en NULL para indicar que el servicio es libre de interpretar la entrada como cualquier idioma de entrada que admita.

pszOutputLanguage

Opcional. Puntero a una cadena de lenguaje de salida, siguiendo la convención de nomenclatura de IETF, que identifica el idioma de salida que el servicio debe poder usar para generar resultados. La aplicación puede establecer este miembro en NULL si el servicio debe decidir el idioma de salida.

pszInputScript

Opcional. Puntero a un nombre de script Unicode estándar que el servicio debe aceptar. La aplicación puede establecer este miembro en NULL para permitir que el servicio decida cómo controlar la entrada.

pszOutputScript

Opcional. Puntero a un nombre de script Unicode estándar que el servicio debe usar para recuperar los resultados. La aplicación puede establecer este miembro en NULL para permitir que el servicio decida el script de salida.

pszInputContentType

Opcional. Puntero a una cadena, siguiendo el formato de los tipos de contenido MIME, que identifica el formato que el servicio debe poder interpretar cuando la aplicación pasa datos. Algunos ejemplos de tipos de contenido son "text/plain", "text/html" y "text/css". La aplicación puede establecer este miembro en NULL para indicar el tipo de contenido "text/plain".

Nota En Windows 7, los servicios ELS solo admiten el tipo de contenido "text/plain". Puede encontrar una especificación de tipo de contenido en Tipos de medios de texto.

 

pszOutputContentType

Opcional. Puntero a una cadena, siguiendo el formato de los tipos de contenido MIME, que identifica el formato en el que el servicio debe recuperar datos. La aplicación puede establecer este miembro en NULL para permitir que el servicio decida el tipo de contenido de salida.

pszUILanguage

Reservado.

pfnRecognizeCallback

Opcional. Puntero a una función de devolución de llamada de aplicación para recibir devoluciones de llamada con los resultados de la función MappingRecognizeText . Si se especifica una función de devolución de llamada, el reconocimiento de texto se ejecuta en modo asincrónico y la aplicación obtiene los resultados a través de la función de devolución de llamada. La aplicación debe establecer este miembro en NULL si el reconocimiento de texto es sincrónico.

pRecognizeCallerData

Opcional. Puntero a los datos de aplicación privados pasados a la función de devolución de llamada por un servicio una vez completado el reconocimiento de texto. La aplicación debe establecer este miembro en NULL para indicar que no hay datos de aplicación privados.

dwRecognizeCallerDataSize

Opcional. Tamaño, en bytes, de cualquier dato de aplicación privada indicado por el miembro pRecognizeCallerData .

pfnActionCallback

Reservado.

pActionCallerData

Reservado.

dwActionCallerDataSize

Reservado.

dwServiceFlag

Opcional. Marca privada que un proveedor de servicios define para afectar al comportamiento del servicio. Los servicios pueden interpretar esta marca según lo necesiten.

Nota Para Windows 7, ninguno de los servicios ELS disponibles admite marcas.

 

GetActionDisplayName

Reservado.

Comentarios

La aplicación no tiene que rellenar todos los miembros de esta estructura, ya que los servicios tratan a los miembros NULL como valores predeterminados. Todos los miembros sin usar deben establecerse en 0.

Advertencia Los datos pasados en esta estructura a MappingRecognizeText, así como los datos a los que hace referencia el argumento pszText en esa llamada,

debe permanecer válido hasta que la estructura del contenedor de propiedades pasada por pBag se libere a través de

MappingFreePropertyBag. Esto se debe a que las llamadas sincrónicas y asincrónicas a

MappingRecognizeText y MappingDoAction intentarán usar los datos pasados a la inicial

llame a MappingRecognizeText.

 

Requisitos

Cliente mínimo compatible	Windows 7 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2008 R2 [aplicaciones de escritorio | Aplicaciones para UWP]
Encabezado	elscore.h

Consulte también

Estructuras extendidas de servicios lingüísticos

MAPPING_DATA_RANGE

MappingRecognizeText