PFN_MAPPINGCALLBACKPROC funzione di callback (elscore.h)

Articolo
08/23/2023

Funzione di callback definita dall'applicazione che elabora in modo asincrono i dati generati dalla funzione MappingRecognizeText . Il tipo MAPPINGCALLBACKPROC definisce un puntatore a questa funzione di callback. MappingCallbackProc è un segnaposto per il nome della funzione definita dall'applicazione.

Sintassi

PFN_MAPPINGCALLBACKPROC PfnMappingcallbackproc;

void PfnMappingcallbackproc(
  [in] _MAPPING_PROPERTY_BAG *pBag,
  [in] LPVOID data,
  [in] DWORD dwDataSize,
  [in] HRESULT Result
)
{...}

Parametri

[in] pBag

Puntatore a una struttura MAPPING_PROPERTY_BAG contenente i risultati della chiamata a MappingRecognizeText.

[in] data

Puntatore ai dati dell'applicazione privata. Questo puntatore è uguale a quello passato nel membro pRecognizeCallerData della struttura MAPPING_OPTIONS .

[in] dwDataSize

Dimensioni, in byte, dei dati dell'applicazione privata. Questa dimensione è uguale a quella passata nel membro dwRecognizeCallerDataSize della struttura MAPPING_OPTIONS quando l'applicazione chiama MappingRecognizeText in modo asincrono.

[in] Result

Restituire il codice da MappingRecognizeText. Il codice restituito è S_OK se la funzione ha avuto esito positivo o un codice di errore in caso contrario.

Valore restituito

nessuno

Osservazioni

Una funzione MappingCallbackProc usa i risultati recuperati da MappingRecognizeText. L'applicazione registra la funzione di callback passandone l'indirizzo a MappingRecognizeText in una struttura MAPPING_OPTIONS .

L'applicazione deve controllare il parametro Result prima di usare i dati nel parametro pBag . Al termine dell'uso dei dati dal contenitore delle proprietà, l'applicazione deve chiamare MappingFreePropertyBag perché il contenitore delle proprietà può contenere puntatori nel testo originale. Per altre informazioni sulla borsa delle proprietà, vedere le osservazioni per la struttura MAPPING_PROPERTY_BAG .

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	elscore.h