Fungsi GetContextPropertyValue (recapis.h)

Artikel
03/01/2024

Mengembalikan nilai properti yang ditentukan dari konteks recognizer.

Sintaks

HRESULT GetContextPropertyValue(
  HRECOCONTEXT hrc,
  GUID         *pGuid,
  ULONG        *pcbSize,
  BYTE         *pProperty
);

Parameter

hrc

Handel ke konteks recognizer.

pGuid

Properti yang akan diambil. Tentukan properti yang telah ditentukan sebelumnya pengidentifikasi unik global (GUID) atau GUID yang ditentukan aplikasi. Untuk daftar properti yang telah ditentukan sebelumnya, lihat GUID Properti pengenalan.

pcbSize

Pada input, ukuran, dalam byte, buffer pProperty bisa. Pada output, ukuran, dalam byte, buffer pProperty adalah.

pProperty

Buffer yang dialokasikan pengguna berisi nilai properti. Untuk menentukan ukuran buffer, atur pProperty ke NULL; gunakan ukuran untuk mengalokasikan pProperty.

Nilai kembali

Fungsi ini dapat mengembalikan salah satu nilai ini.

Menampilkan kode	Deskripsi
S_OK	Berhasil.
E_POINTER	Salah satu parameter adalah penunjuk yang tidak valid.
E_FAIL	Terjadi kesalahan yang tidak ditentukan.
E_INVALIDARG	Argumen yang tidak valid diterima.
TPC_E_UNINITIALIZED_PROPERTY	Properti belum diatur oleh konteks. Ini dapat terjadi jika properti diatur hanya dalam keadaan tertentu, atau jika properti akan diatur hanya setelah peristiwa yang belum terjadi.
TPC_E_INVALID_PROPERTY	Recognizer tidak mendukung properti .
TPC_E_INSUFFICIENT_BUFFER	Buffer pProperty terlalu kecil.

Keterangan

Fungsi ini bersifat opsional.

Anda dapat menggunakan fungsi GetContextPropertyValue untuk mendapatkan informasi bahwa pengenal kembali ke pemanggil. Ini memungkinkan pengenal yang disesuaikan untuk memiliki mode dan pengaturan, dan untuk mengembalikan data yang unik untuk pengenal tersebut.

Dalam pengenal Microsoft, memanggil fungsi GetContextPropertyValue dengan parameter pcbSize yang diatur ke nilai yang lebih besar dari yang diperlukan tidak menghasilkan nilai pengembalian yang salah. Sebaliknya, kode secara otomatis mengubah ukuran ke nilai yang diperlukan untuk GUID saat ini.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP Tablet PC Edition [hanya aplikasi desktop]
Server minimum yang didukung	Tidak ada yang didukung
Target Platform	Windows
Header	recapis.h
DLL	inkobjcore.dll

Lihat juga

Fungsi GetContextPropertyList

Fungsi SetContextPropertyValue

Bagikan melalui