Função MappingDoAction (elscore.h)

Faz com que um serviço ELS execute uma ação após o reconhecimento de texto. Por exemplo, um serviço de discagem de telefone primeiro deve reconhecer números de telefone e, em seguida, pode executar a "ação" de discar um número.

Sintaxe

HRESULT MappingDoAction(
  [in, out] PMAPPING_PROPERTY_BAG pBag,
  [in]      DWORD                 dwRangeIndex,
  [in]      LPCWSTR               pszActionId
);

Parâmetros

[in, out] pBag

Ponteiro para uma estrutura MAPPING_PROPERTY_BAG que contém os resultados de uma chamada anterior para MappingRecognizeText. Esse parâmetro não pode ser definido como NULL.

[in] dwRangeIndex

Um índice inicial dentro do reconhecimento de texto resulta em um intervalo de texto reconhecido. Esse valor deve estar entre 0 e a contagem de intervalos.

[in] pszActionId

Ponteiro para o identificador da ação a ser executada. 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 aplicativo deve preceder a chamada para MappingDoAction com uma chamada para MappingRecognizeText.

Aviso Os dados referenciados pelos argumentos pszText e pOptions passados para MappingRecognizeText

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 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	elscore.h
Biblioteca	Elscore.lib
DLL	Elscore.dll

Confira também

Serviços Linguísticos Estendidos

Funções de Serviços Linguísticos Estendidos

MAPPING_PROPERTY_BAG

MappingRecognizeText