PFN_MAPPINGCALLBACKPROC función de devolución de llamada (elscore.h)

Artículo
02/29/2024

Función de devolución de llamada definida por la aplicación que procesa de forma asincrónica los datos generados por la función MappingRecognizeText . El tipo MAPPINGCALLBACKPROC define un puntero a esta función de devolución de llamada. MappingCallbackProc es un marcador de posición para el nombre de función definido por la aplicación.

Sintaxis

PFN_MAPPINGCALLBACKPROC PfnMappingcallbackproc;

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

Parámetros

[in] pBag

Puntero a una estructura de MAPPING_PROPERTY_BAG que contiene los resultados de la llamada a MappingRecognizeText.

[in] data

Puntero a los datos de la aplicación privada. Este puntero es el mismo que el pasado en el miembro pRecognizeCallerData de la estructura MAPPING_OPTIONS .

[in] dwDataSize

Tamaño, en bytes, de los datos de la aplicación privada. Este tamaño es el mismo que el pasado en el miembro dwRecognizeCallerDataSize de la estructura de MAPPING_OPTIONS cuando la aplicación llama a MappingRecognizeText de forma asincrónica.

[in] Result

Devuelve código de MappingRecognizeText. El código de retorno se S_OK si la función se realizó correctamente o un código de error en caso contrario.

Valor devuelto

None

Observaciones

Una función MappingCallbackProc consume los resultados recuperados por MappingRecognizeText. La aplicación registra la función de devolución de llamada pasando su dirección a MappingRecognizeText en una estructura de MAPPING_OPTIONS .

La aplicación debe comprobar el parámetro Result antes de usar los datos en el parámetro pBag . Cuando haya terminado de usar los datos del contenedor de propiedades, la aplicación debe llamar a MappingFreePropertyBag porque el contenedor de propiedades puede contener punteros al texto original. Para obtener más información sobre el contenedor de propiedades, vea los comentarios de la estructura de MAPPING_PROPERTY_BAG .

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 R2 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	elscore.h