Função MappingRecognizeText (elscore.h)

Artigo
08/23/2023

Chama um serviço ELS para reconhecer texto. Por exemplo, o serviço de Detecção de Idioma da Microsoft tentará reconhecer o idioma no qual o texto de entrada é escrito.

Sintaxe

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

Ponteiro para uma estrutura MAPPING_SERVICE_INFO que contém informações sobre o serviço a ser usado no reconhecimento de texto. A estrutura deve ser uma das estruturas recuperadas por uma chamada anterior para MappingGetServices. Esse parâmetro não pode ser definido como NULL.

[in] pszText

Ponteiro para o texto a ser reconhecido. O texto deve ser UTF-16, mas alguns serviços têm requisitos adicionais para o formato de entrada. Esse parâmetro não pode ser definido como NULL.

[in] dwLength

Comprimento, em caracteres, do texto especificado em pszText.

[in] dwIndex

Índice dentro do texto especificado a ser usado pelo serviço. Esse valor deve estar entre 0 e dwLength-1. Se o aplicativo quiser processar todo o texto, ele deverá definir esse parâmetro como 0.

[in, optional] pOptions

Ponteiro para uma estrutura MAPPING_OPTIONS que contém opções que afetam o resultado e o comportamento do reconhecimento de texto. O aplicativo não precisa especificar valores para todos os membros da estrutura. Esse parâmetro pode ser definido como NULL para usar as opções de mapeamento padrão.

[in, out] pbag

Ponteiro para uma estrutura MAPPING_PROPERTY_BAG na qual o serviço armazena seus resultados. Na entrada, o aplicativo passa uma estrutura com apenas o tamanho fornecido e os outros membros definidos como 0. Na saída, a estrutura é preenchida com informações produzidas pelo serviço durante o reconhecimento de texto. Esse parâmetro não pode ser definido como NULL.

Valor retornado

Retorna S_OK se tiver êxito. A função retornará um valor HRESULT de erro se não for bem-sucedida.

Comentários

O tipo de texto a ser reconhecido depende do tipo de serviço usado pelo aplicativo. Para obter mais informações, consulte Solicitando reconhecimento de texto.

Aviso Os dados referenciados por pszText e pOptions devem permanecer válidos até que a estrutura do recipiente de propriedades passada por pBag seja liberada por meio de

MappingFreePropertyBag. Isso ocorre porque chamadas síncronas e assíncronas para

MappingRecognizeText e MappingDoAction tentarão usar os dados passados para a inicial

chame para MappingRecognizeText.

Requisitos


Cliente mínimo com suporte	Windows 7 [aplicativos da área de trabalho \| Aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2008 R2 [aplicativos da área de trabalho \| Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	elscore.h
Biblioteca	Elscore.lib
DLL	Elscore.dll