Fungsi MappingRecognizeText (elscore.h)

Artikel
08/23/2023

Memanggil layanan ELS untuk mengenali teks. Misalnya, layanan Deteksi Bahasa Microsoft akan mencoba mengenali bahasa tempat teks input ditulis.

Sintaks

HRESULT MappingRecognizeText(
  [in]           PMAPPING_SERVICE_INFO pServiceInfo,
  [in]           LPCWSTR               pszText,
  [in]           DWORD                 dwLength,
  [in]           DWORD                 dwIndex,
  [in, optional] PMAPPING_OPTIONS      pOptions,
  [in, out]      PMAPPING_PROPERTY_BAG pbag
);

Parameter

[in] pServiceInfo

Arahkan ke struktur MAPPING_SERVICE_INFO yang berisi informasi tentang layanan yang akan digunakan dalam pengenalan teks. Struktur harus merupakan salah satu struktur yang diambil oleh panggilan sebelumnya ke MappingGetServices. Parameter ini tidak dapat diatur ke NULL.

[in] pszText

Arahkan ke teks untuk mengenali. Teks harus UTF-16, tetapi beberapa layanan memiliki persyaratan tambahan untuk format input. Parameter ini tidak dapat diatur ke NULL.

[in] dwLength

Panjang, dalam karakter, dari teks yang ditentukan dalam pszText.

[in] dwIndex

Indeks di dalam teks yang ditentukan untuk digunakan oleh layanan. Nilai ini harus antara 0 dan dwLength-1. Jika aplikasi ingin memproses seluruh teks, aplikasi harus mengatur parameter ini ke 0.

[in, optional] pOptions

Penunjuk ke struktur MAPPING_OPTIONS yang berisi opsi yang memengaruhi hasil dan perilaku pengenalan teks. Aplikasi tidak harus menentukan nilai untuk semua anggota struktur. Parameter ini dapat diatur ke NULL untuk menggunakan opsi pemetaan default.

[in, out] pbag

Arahkan ke struktur MAPPING_PROPERTY_BAG tempat layanan menyimpan hasilnya. Pada input, aplikasi meneruskan struktur hanya dengan ukuran yang disediakan, dan anggota lain diatur ke 0. Pada output, struktur diisi dengan informasi yang dihasilkan oleh layanan selama pengenalan teks. Parameter ini tidak dapat diatur ke NULL.

Mengembalikan nilai

Mengembalikan S_OK jika berhasil. Fungsi mengembalikan nilai HRESULT kesalahan jika tidak berhasil.

Keterangan

Jenis teks yang dikenali tergantung pada jenis layanan yang digunakan oleh aplikasi. Untuk informasi selengkapnya, lihat Meminta Pengenalan Teks.

Peringatan Data yang disebutkan oleh pszText dan pOptions harus tetap valid sampai struktur tas properti yang diteruskan oleh pBag dikosongkan melalui

PemetaanFreePropertyBag. Ini karena panggilan sinkron dan asinkron ke

MappingRecognizeText dan MappingDoAction akan mencoba menggunakan data yang diteruskan ke awal

panggilan ke MappingRecognizeText.

Persyaratan


Klien minimum yang didukung	Windows 7 [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows Server 2008 R2 [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	elscore.h
Pustaka	Elscore.lib
DLL	Elscore.dll