PFN_MAPPINGCALLBACKPROC fungsi panggilan balik (elscore.h)

Artikel
08/23/2023

Fungsi panggilan balik yang ditentukan aplikasi yang secara asinkron memproses data yang dihasilkan oleh fungsi MappingRecognizeText . Jenis MAPPINGCALLBACKPROC menentukan penunjuk ke fungsi panggilan balik ini. MappingCallbackProc adalah tempat penampung untuk nama fungsi yang ditentukan aplikasi.

Sintaks

PFN_MAPPINGCALLBACKPROC PfnMappingcallbackproc;

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

Parameter

[in] pBag

Penunjuk ke struktur MAPPING_PROPERTY_BAG yang berisi hasil panggilan ke MappingRecognizeText.

[in] data

Arahkan ke data aplikasi privat. Penunjuk ini sama dengan yang diteruskan di anggota pRecognizeCallerData dari struktur MAPPING_OPTIONS .

[in] dwDataSize

Ukuran, dalam byte, dari data aplikasi privat. Ukuran ini sama dengan yang diteruskan di anggota dwRecognizeCallerDataSize dari struktur MAPPING_OPTIONS saat aplikasi memanggil MappingRecognizeText secara asinkron.

[in] Result

Mengembalikan kode dari MappingRecognizeText. Kode pengembalian S_OK jika fungsi berhasil, atau kode kesalahan sebaliknya.

Nilai kembali

Tidak ada

Keterangan

Fungsi MappingCallbackProc menggunakan hasil yang diambil oleh MappingRecognizeText. Aplikasi mendaftarkan fungsi panggilan balik dengan meneruskan alamatnya ke MappingRecognizeText dalam struktur MAPPING_OPTIONS .

Aplikasi harus memeriksa parameter Hasil sebelum menggunakan data dalam parameter pBag . Ketika selesai menggunakan data dari tas properti, aplikasi harus memanggil MappingFreePropertyBag karena tas properti dapat berisi pointer ke dalam teks asli. Untuk informasi selengkapnya tentang tas properti, lihat keterangan untuk struktur MAPPING_PROPERTY_BAG .

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 R2 [hanya aplikasi desktop]
Target Platform	Windows
Header	elscore.h