Funzione MappingRecognizeText (elscore.h)

Articolo
08/23/2023

Chiama un servizio ELS per riconoscere il testo. Ad esempio, il servizio Rilevamento lingua Microsoft tenterà di riconoscere la lingua in cui viene scritto il testo di input.

Sintassi

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

Parametri

[in] pServiceInfo

Puntatore a una struttura MAPPING_SERVICE_INFO contenente informazioni sul servizio da usare nel riconoscimento del testo. La struttura deve essere una delle strutture recuperate da una chiamata precedente a MappingGetServices. Questo parametro non può essere impostato su NULL.

[in] pszText

Puntatore al testo da riconoscere. Il testo deve essere UTF-16, ma alcuni servizi hanno requisiti aggiuntivi per il formato di input. Questo parametro non può essere impostato su NULL.

[in] dwLength

Lunghezza, in caratteri, del testo specificato in pszText.

[in] dwIndex

Indice all'interno del testo specificato da utilizzare dal servizio. Questo valore deve essere compreso tra 0 e dwLength-1. Se l'applicazione vuole elaborare l'intero testo, deve impostare questo parametro su 0.

[in, optional] pOptions

Puntatore a una struttura MAPPING_OPTIONS contenente opzioni che influiscono sul risultato e sul comportamento del riconoscimento del testo. L'applicazione non deve specificare valori per tutti i membri della struttura. Questo parametro può essere impostato su NULL per usare le opzioni di mapping predefinite.

[in, out] pbag

Puntatore a una struttura MAPPING_PROPERTY_BAG in cui il servizio archivia i risultati. In input, l'applicazione passa una struttura con solo le dimensioni specificate e gli altri membri impostati su 0. Nell'output, la struttura viene compilata con informazioni prodotte dal servizio durante il riconoscimento del testo. Questo parametro non può essere impostato su NULL.

Valore restituito

Restituisce S_OK in caso di esito positivo. La funzione restituisce un valore HRESULT di errore se non riesce.

Commenti

Il tipo di testo da riconoscere dipende dal tipo di servizio usato dall'applicazione. Per altre informazioni, vedere Richiesta di riconoscimento del testo.

Avviso I dati a cui fa riferimento pszText e pOptions devono rimanere validi fino a quando la struttura del contenitore delle proprietà passata da pBag viene liberata tramite

MappingFreePropertyBag. Ciò è dovuto al fatto che sia le chiamate sincrone che asincrone a

MappingRecognizeText e MappingDoAction tenteranno di usare i dati passati all'iniziale

chiamare a MappingRecognizeText.

Requisiti


Client minimo supportato	Windows 7 [app desktop \| App UWP]
Server minimo supportato	Windows Server 2008 R2 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	elscore.h
Libreria	Elscore.lib
DLL	Elscore.dll