estrutura MAPPING_OPTIONS (elscore.h)

Contém opções para reconhecimento de texto. Os valores armazenados nessa estrutura afetam o comportamento e os resultados de MappingRecognizeText.

Sintaxe

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;

Membros

Size

Tamanho da estrutura, usada para validar a versão da estrutura. Esse valor é necessário.

pszInputLanguage

Opcional. Ponteiro para uma cadeia de caracteres de idioma de entrada, seguindo a convenção de nomenclatura IETF, que identifica o idioma de entrada que o serviço deve ser capaz de aceitar. O aplicativo pode definir esse membro como NULL para indicar que o serviço é gratuito para interpretar a entrada como qualquer idioma de entrada compatível.

pszOutputLanguage

Opcional. Ponteiro para uma cadeia de caracteres de idioma de saída, seguindo a convenção de nomenclatura IETF, que identifica o idioma de saída que o serviço deve ser capaz de usar para produzir resultados. O aplicativo poderá definir esse membro como NULL se o serviço decidir o idioma de saída.

pszInputScript

Opcional. Ponteiro para um nome de script Unicode padrão que deve ser aceito pelo serviço. O aplicativo pode definir esse membro como NULL para permitir que o serviço decida como manipular a entrada.

pszOutputScript

Opcional. Ponteiro para um nome de script Unicode padrão que o serviço deve usar para recuperar resultados. O aplicativo pode definir esse membro como NULL para permitir que o serviço decida o script de saída.

pszInputContentType

Opcional. Ponteiro para uma cadeia de caracteres, seguindo o formato dos tipos de conteúdo MIME, que identifica o formato que o serviço deve ser capaz de interpretar quando o aplicativo passa dados. Exemplos de tipos de conteúdo são "text/plain", "text/html" e "text/css". O aplicativo pode definir esse membro como NULL para indicar o tipo de conteúdo "texto/sem formatação".

Nota No Windows 7, os serviços ELS dão suporte apenas ao tipo de conteúdo "text/plain". Uma especificação de tipo de conteúdo pode ser encontrada em Tipos de Mídia de Texto.

 

pszOutputContentType

Opcional. Ponteiro para uma cadeia de caracteres, seguindo o formato dos tipos de conteúdo MIME, que identifica o formato no qual o serviço deve recuperar dados. O aplicativo pode definir esse membro como NULL para permitir que o serviço decida o tipo de conteúdo de saída.

pszUILanguage

Reservado.

pfnRecognizeCallback

Opcional. Ponteiro para uma função de retorno de chamada de aplicativo para receber retornos de chamada com os resultados da função MappingRecognizeText . Se uma função de retorno de chamada for especificada, o reconhecimento de texto será executado no modo assíncrono e o aplicativo obterá resultados por meio da função de retorno de chamada. O aplicativo deverá definir esse membro como NULL se o reconhecimento de texto for síncrono.

pRecognizeCallerData

Opcional. Ponteiro para dados de aplicativo privado passados para a função de retorno de chamada por um serviço após a conclusão do reconhecimento de texto. O aplicativo deve definir esse membro como NULL para indicar nenhum dado de aplicativo privado.

dwRecognizeCallerDataSize

Opcional. Tamanho, em bytes, de qualquer dado de aplicativo privado indicado pelo membro pRecognizeCallerData .

pfnActionCallback

Reservado.

pActionCallerData

Reservado.

dwActionCallerDataSize

Reservado.

dwServiceFlag

Opcional. Sinalizador privado que um provedor de serviços define para afetar o comportamento do serviço. Os serviços podem interpretar esse sinalizador conforme necessário.

Nota Para o Windows 7, nenhum dos serviços ELS disponíveis dá suporte a sinalizadores.

 

GetActionDisplayName

Reservado.

Comentários

O aplicativo não precisa preencher todos os membros dessa estrutura, pois os serviços tratam membros NULL como valores padrão. Todos os membros não utilizados devem ser definidos como 0.

Aviso Os dados passados nessa estrutura para MappingRecognizeText, bem como os dados mencionados pelo argumento pszText nessa chamada,

deve permanecer válido 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]
Cabeçalho	elscore.h

Confira também

Estruturas de Serviços Linguísticos Estendidos

MAPPING_DATA_RANGE

MappingRecognizeText