Función MappingRecognizeText (elscore.h)

Artículo
08/23/2023

Llama a un servicio ELS para reconocer texto. Por ejemplo, el servicio Detección de idioma de Microsoft intentará reconocer el idioma en el que se escribe el texto de entrada.

Sintaxis

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
);

Parámetros

[in] pServiceInfo

Puntero a una estructura de MAPPING_SERVICE_INFO que contiene información sobre el servicio que se va a usar en el reconocimiento de texto. La estructura debe ser una de las estructuras recuperadas por una llamada anterior a MappingGetServices. Este parámetro no se puede establecer en NULL.

[in] pszText

Puntero al texto que se va a reconocer. El texto debe ser UTF-16, pero algunos servicios tienen requisitos adicionales para el formato de entrada. Este parámetro no se puede establecer en NULL.

[in] dwLength

Longitud, en caracteres, del texto especificado en pszText.

[in] dwIndex

Índice dentro del texto especificado que va a usar el servicio. Este valor debe estar comprendido entre 0 y dwLength-1. Si la aplicación quiere procesar todo el texto, debe establecer este parámetro en 0.

[in, optional] pOptions

Puntero a una estructura de MAPPING_OPTIONS que contiene opciones que afectan al resultado y al comportamiento del reconocimiento de texto. La aplicación no tiene que especificar valores para todos los miembros de la estructura. Este parámetro se puede establecer en NULL para usar las opciones de asignación predeterminadas.

[in, out] pbag

Puntero a una estructura MAPPING_PROPERTY_BAG en la que el servicio almacena sus resultados. En la entrada, la aplicación pasa una estructura con solo el tamaño proporcionado y los demás miembros establecidos en 0. En la salida, la estructura se rellena con información generada por el servicio durante el reconocimiento de texto. Este parámetro no se puede establecer en NULL.

Valor devuelto

Devuelve S_OK si se ejecuta correctamente. La función devuelve un valor HRESULT de error si no se realiza correctamente.

Comentarios

El tipo de texto que se va a reconocer depende del tipo de servicio utilizado por la aplicación. Para obtener más información, consulte Solicitud de reconocimiento de texto.

Advertencia Los datos a los que hace referencia pszText y pOptions deben permanecer válidos 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]
Plataforma de destino	Windows
Encabezado	elscore.h
Library	Elscore.lib
Archivo DLL	Elscore.dll