struktur MAPPING_OPTIONS (elscore.h)

Berisi opsi untuk pengenalan teks. Nilai yang disimpan dalam struktur ini memengaruhi perilaku dan hasil MappingRecognizeText.

Sintaks

typedef struct _MAPPING_OPTIONS {
  size_t                  Size;
  LPWSTR                  pszInputLanguage;
  LPWSTR                  pszOutputLanguage;
  LPWSTR                  pszInputScript;
  LPWSTR                  pszOutputScript;
  LPWSTR                  pszInputContentType;
  LPWSTR                  pszOutputContentType;
  LPWSTR                  pszUILanguage;
  PFN_MAPPINGCALLBACKPROC pfnRecognizeCallback;
  LPVOID                  pRecognizeCallerData;
  DWORD                   dwRecognizeCallerDataSize;
  PFN_MAPPINGCALLBACKPROC pfnActionCallback;
  LPVOID                  pActionCallerData;
  DWORD                   dwActionCallerDataSize;
  DWORD                   dwServiceFlag;
  unsigned                GetActionDisplayName : 1;
} MAPPING_OPTIONS, *PMAPPING_OPTIONS;

Anggota

Size

Ukuran struktur, digunakan untuk memvalidasi versi struktur. Nilai ini diperlukan.

pszInputLanguage

Opsional. Penunjuk ke string bahasa input, mengikuti konvensi penamaan IETF, yang mengidentifikasi bahasa input yang harus dapat diterima layanan. Aplikasi dapat mengatur anggota ini ke NULL untuk menunjukkan bahwa layanan bebas untuk menginterpretasikan input sebagai bahasa input apa pun yang didukungnya.

pszOutputLanguage

Pilihan. Penunjuk ke string bahasa output, mengikuti konvensi penamaan IETF, yang mengidentifikasi bahasa output yang harus dapat digunakan layanan untuk menghasilkan hasil. Aplikasi dapat mengatur anggota ini ke NULL jika layanan harus memutuskan bahasa output.

pszInputScript

Pilihan. Penunjuk ke nama skrip Unicode standar yang harus diterima oleh layanan. Aplikasi dapat mengatur anggota ini ke NULL untuk membiarkan layanan memutuskan bagaimana menangani input.

pszOutputScript

Pilihan. Arahkan ke nama skrip Unicode standar yang harus digunakan layanan untuk mengambil hasil. Aplikasi dapat mengatur anggota ini ke NULL untuk memungkinkan layanan memutuskan skrip output.

pszInputContentType

Pilihan. Penunjuk ke string, mengikuti format jenis konten MIME, yang mengidentifikasi format yang harus dapat ditafsirkan layanan saat aplikasi meneruskan data. Contoh jenis konten adalah "text/plain", "text/html", dan "text/css". Aplikasi dapat mengatur anggota ini ke NULL untuk menunjukkan jenis konten "teks/biasa".

Catatan Di Windows 7, layanan ELS hanya mendukung jenis konten "teks/biasa". Spesifikasi tipe isi dapat ditemukan di Tipe Media Teks.

 

pszOutputContentType

Pilihan. Penunjuk ke string, mengikuti format jenis konten MIME, yang mengidentifikasi format di mana layanan harus mengambil data. Aplikasi dapat mengatur anggota ini ke NULL untuk memungkinkan layanan memutuskan jenis konten output.

pszUILanguage

Dicadangkan.

pfnRecognizeCallback

Pilihan. Arahkan ke fungsi panggilan balik aplikasi untuk menerima panggilan balik dengan hasil dari fungsi MappingRecognizeText . Jika fungsi panggilan balik ditentukan, pengenalan teks dijalankan dalam mode asinkron dan aplikasi mendapatkan hasil melalui fungsi panggilan balik. Aplikasi harus mengatur anggota ini ke NULL jika pengenalan teks harus sinkron.

pRecognizeCallerData

Pilihan. Penunjuk ke data aplikasi privat yang diteruskan ke fungsi panggilan balik oleh layanan setelah pengenalan teks selesai. Aplikasi harus mengatur anggota ini ke NULL untuk menunjukkan tidak ada data aplikasi privat.

dwRecognizeCallerDataSize

Pilihan. Ukuran, dalam byte, dari data aplikasi privat apa pun yang ditunjukkan oleh anggota pRecognizeCallerData .

pfnActionCallback

Dicadangkan.

pActionCallerData

Dicadangkan.

dwActionCallerDataSize

Dicadangkan.

dwServiceFlag

Pilihan. Bendera privat yang ditentukan penyedia layanan untuk memengaruhi perilaku layanan. Layanan dapat menafsirkan bendera ini sesuai kebutuhan.

Catatan Untuk Windows 7, tidak ada bendera dukungan layanan ELS yang tersedia.

 

GetActionDisplayName

Dicadangkan.

Keterangan

Aplikasi tidak harus mengisi semua anggota struktur ini, karena layanan memperlakukan anggota NULL sebagai nilai default. Semua anggota yang tidak digunakan harus diatur ke 0.

Peringatan Data yang diteruskan dalam struktur ini ke MappingRecognizeText, serta data yang disebut oleh argumen pszText dalam panggilan tersebut,

harus tetap berlaku sampai struktur tas properti yang diteruskan oleh pBag dibebaskan melalui

MappingFreePropertyBag. 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]
Header	elscore.h

Lihat juga

Struktur Layanan Linguistik yang Diperluas

MAPPING_DATA_RANGE

MappingRecognizeText