Bagikan melalui

Fungsi WinBioAcquireFocus (winbio.h)

  • Artikel

Memperoleh fokus jendela.

Sintaks

HRESULT WinBioAcquireFocus();

Mengembalikan nilai

Jika fungsi berhasil, fungsi akan mengembalikan S_OK. Jika fungsi gagal, fungsi mengembalikan nilai HRESULT yang menunjukkan kesalahan. Nilai yang mungkin termasuk, tetapi tidak terbatas pada, yang ada dalam tabel berikut. Untuk daftar kode kesalahan umum, lihat Nilai HRESULT Umum.

Menampilkan kode Deskripsi
E_ACCESSDENIED
 Proses panggilan harus berjalan di bawah akun Sistem Lokal.

Keterangan

Windows Biometric Framework menggunakan fokus jendela untuk arbitrase di antara beberapa sesi yang terhubung ke kumpulan sistem.

Cara Anda memperoleh fokus tergantung pada jenis aplikasi yang Anda tulis. Misalnya, jika Anda membuat aplikasi GUI, Anda dapat mengimplementasikan penangan pesan yang menangkap WM_ACTIVATE, WM_SETFOCUS, atau pesan lain yang sesuai. Jika Anda menulis aplikasi CUI, panggil GetConsoleWindow untuk mengambil handel ke jendela konsol dan meneruskan handel tersebut ke fungsi SetForegroundWindow untuk memaksa jendela konsol ke latar depan dan menetapkan fokusnya. Jika aplikasi Anda berjalan dalam proses yang dilepas atau merupakan layanan Windows dan tidak memiliki jendela, gunakan WinBioAcquireFocus dan WinBioReleaseFocus untuk mengontrol fokus secara manual.

Daftar berikut ini meringkas poin utama yang perlu dipertimbangkan sebelum memanggil fungsi ini.

  • Proses panggilan harus berjalan di bawah akun Sistem Lokal.
  • Proses yang secara langsung menampilkan antarmuka pengguna tidak boleh memanggil fungsi ini. Lihat diskusi sebelumnya untuk menentukan cara memperoleh fokus untuk aplikasi GUI dan CUI.
  • Hanya layanan atau proses yang dilepas yang tidak secara langsung menampilkan antarmuka pengguna selama panggilan API biometrik yang harus memanggil fungsi ini.
  • Jika fungsi berhasil, Anda harus memanggil WinBioReleaseFocus untuk merilis fokus.
Jika Anda tidak memperoleh fokus saat memanggil fungsi berikut, mereka akan berperilaku dengan cara yang tidak terduga:

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 winbio.h (termasuk Winbio.h)
Pustaka Winbio.lib
DLL Winbio.dll

Lihat juga

Fungsi Aplikasi Klien

WinBioEnrollBegin