struttura MAPPING_OPTIONS (elscore.h)
Contiene le opzioni per il riconoscimento del testo. I valori archiviati in questa struttura influiscono sul comportamento e sui risultati di MappingRecognizeText.
Sintassi
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;
Members
Size
Dimensione della struttura utilizzata per convalidare la versione della struttura. Questo valore è obbligatorio.
pszInputLanguage
Facoltativa. Puntatore a una stringa della lingua di input, seguendo la convenzione di denominazione IETF, che identifica la lingua di input che il servizio deve essere in grado di accettare. L'applicazione può impostare questo membro su NULL per indicare che il servizio è libero di interpretare l'input come qualsiasi lingua di input supportata.
pszOutputLanguage
Facoltativa. Puntatore a una stringa del linguaggio di output, seguendo la convenzione di denominazione IETF, che identifica il linguaggio di output che il servizio deve essere in grado di usare per produrre risultati. L'applicazione può impostare questo membro su NULL se il servizio deve decidere la lingua di output.
pszInputScript
Facoltativa. Puntatore a un nome di script Unicode standard che deve essere accettato dal servizio. L'applicazione può impostare questo membro su NULL per consentire al servizio di decidere come gestire l'input.
pszOutputScript
Facoltativa. Puntatore a un nome di script Unicode standard che il servizio deve usare per recuperare i risultati. L'applicazione può impostare questo membro su NULL per consentire al servizio di decidere lo script di output.
pszInputContentType
Facoltativa. Puntatore a una stringa, seguendo il formato dei tipi di contenuto MIME, che identifica il formato che il servizio deve essere in grado di interpretare quando l'applicazione passa i dati. Esempi di tipi di contenuto sono "text/plain", "text/html" e "text/css". L'applicazione può impostare questo membro su NULL per indicare il tipo di contenuto "text/plain".
pszOutputContentType
Facoltativa. Puntatore a una stringa, seguendo il formato dei tipi di contenuto MIME, che identifica il formato in cui il servizio deve recuperare i dati. L'applicazione può impostare questo membro su NULL per consentire al servizio di decidere il tipo di contenuto di output.
pszUILanguage
Riservato.
pfnRecognizeCallback
Facoltativa. Puntatore a una funzione di callback dell'applicazione per ricevere i callback con i risultati della funzione MappingRecognizeText . Se viene specificata una funzione di callback, il riconoscimento del testo viene eseguito in modalità asincrona e l'applicazione ottiene i risultati tramite la funzione di callback. L'applicazione deve impostare questo membro su NULL se il riconoscimento del testo deve essere sincrono.
pRecognizeCallerData
Facoltativa. Puntatore ai dati dell'applicazione privati passati alla funzione di callback da un servizio al termine del riconoscimento del testo. L'applicazione deve impostare questo membro su NULL per indicare che non sono presenti dati dell'applicazione privati.
dwRecognizeCallerDataSize
Facoltativa. Dimensioni, in byte, di tutti i dati dell'applicazione privata indicati dal membro pRecognizeCallerData .
pfnActionCallback
Riservato.
pActionCallerData
Riservato.
dwActionCallerDataSize
Riservato.
dwServiceFlag
Facoltativa. Flag privato definito da un provider di servizi per influire sul comportamento del servizio. I servizi possono interpretare questo flag in quanto necessari.
GetActionDisplayName
Riservato.
Commenti
L'applicazione non deve compilare tutti i membri di questa struttura, perché i servizi considerano i membri NULL come valori predefiniti. Tutti i membri inutilizzati devono essere impostati su 0.
deve rimanere valido 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] |
| Intestazione | elscore.h |