функция обратного вызова PFN_MAPPINGCALLBACKPROC (elscore.h)

Статья
08/23/2023

Определяемая приложением функция обратного вызова, которая асинхронно обрабатывает данные, созданные функцией MappingRecognizeText . Тип MAPPINGCALLBACKPROC определяет указатель на эту функцию обратного вызова. MappingCallbackProc — это заполнитель для имени функции, определяемой приложением.

Синтаксис

PFN_MAPPINGCALLBACKPROC PfnMappingcallbackproc;

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

Параметры

[in] pBag

Указатель на структуру MAPPING_PROPERTY_BAG , содержащую результаты вызова MappingRecognizeText.

[in] data

Указатель на частные данные приложения. Этот указатель такой же, как и в элементе pRecognizeCallerData структуры MAPPING_OPTIONS .

[in] dwDataSize

Размер данных частного приложения (в байтах). Этот размер такой же, как и в элементе dwRecognizeCallerDataSizeструктуры MAPPING_OPTIONS , когда приложение вызывает MappingRecognizeText асинхронно.

[in] Result

Возвращает код из MappingRecognizeText. Код возврата S_OK, если функция выполнена успешно, или код ошибки в противном случае.

Возвращаемое значение

None

Remarks

Функция MappingCallbackProc использует результаты, полученные MappingRecognizeText. Приложение регистрирует функцию обратного вызова, передавая ее адрес в MappingRecognizeText в MAPPING_OPTIONS структуре.

Приложение должно проверка параметр Result перед использованием данных в параметре pBag. После этого с использованием данных из контейнера свойств приложение должно вызвать MappingFreePropertyBag , так как контейнер свойств может содержать указатели на исходный текст. Дополнительные сведения о контейнере свойств см. в примечаниях к структуре MAPPING_PROPERTY_BAG .

Требования

Требование	Значение
Минимальная версия клиента	Windows 7 [только классические приложения]
Минимальная версия сервера	Windows Server 2008 R2 [только классические приложения]
Целевая платформа	Windows
Header	elscore.h