Fungsi WinBioEnrollSelect (winbio.h)

Artikel
03/03/2024

Menentukan individu yang ingin Anda daftarkan saat data yang mewakili beberapa individu ada dalam buffer sampel. Dimulai dengan Windows 10, build 1607, fungsi ini tersedia untuk digunakan dengan gambar seluler.

Sintaks

HRESULT WinBioEnrollSelect(
  [in] WINBIO_SESSION_HANDLE SessionHandle,
  [in] ULONGLONG             SelectorValue
);

Parameter

[in] SessionHandle

Nilai WINBIO_SESSION_HANDLE yang mengidentifikasi sesi biometrik terbuka. Buka handel sesi sinkron dengan memanggil WinBioOpenSession. Buka handel sesi asinkron dengan memanggil WinBioAsyncOpenSession.

Untuk pendaftaran pengenalan wajah, gunakan WinBioAsyncOpenSession dengan parameter PoolType yang diatur ke WINBIO_POOL_SYSTEM untuk mendapatkan handel.

[in] SelectorValue

Nilai yang mengidentifikasi bahwa individu yang ingin Anda pilih untuk pendaftaran.

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_HANDLE	Handel sesi tidak valid.
E_INVALIDARG	Parameter SelectorValue tidak boleh sama dengan nol.
WINBIO_E_INCORRECT_SESSION_TYPE	Handel sesi tidak sesuai dengan sesi biometrik.

Keterangan

Untuk pendaftaran pengenalan wajah, Anda dapat menemukan nilai pemilih yang benar dengan salah satu dari dua cara:

Nilai anggota Id dari salah satu struktur WINBIO_PRESENCE yang sebelumnya dikirim.
Data yang dihasilkan oleh API pelacakan wajah NUI.

Panggil WinBioEnrollSelect untuk mengatur nilai pemilih setelah Anda memanggil WinBioEnrollBegin untuk memulai urutan pendaftaran. Nilai pemilih berlaku untuk semua panggilan WinBioEnrollCapture berikutnya. Pengaturan pilihan bersifat sementara dan secara otomatis dihapus ketika Anda menyelesaikan urutan pendaftaran dengan memanggil WinBioEnrollCommit atau WinBioEnrollDiscard.

Jika Anda memanggil WinBioEnrollSelect untuk faktor biometrik yang tidak memerlukan disambiguasi, seperti sidik jari, nilai pengembalian untuk fungsi menunjukkan keberhasilan, tetapi fungsi mengabaikan nilai pemilih.

Jika Anda tidak memanggil WinBioEnrollSelect untuk faktor biometrik yang mengharuskan Anda memanggil fungsi, panggilan berikutnya ke WinBioEnrollCapture gagal dengan kesalahan WINBIO_E_SELECTION_REQUIRED .

Untuk Windows 10, faktor-faktor yang mengharuskan Anda memanggil WinBioEnrollSelect adalah fitur wajah dan iris.

Anda dapat memanggil WinBioEnrollSelect dengan menggunakan handel sesi sinkron atau asinkron. Seperti halnya panggilan lain ke fungsi Windows Biometric Framework API, ketika Anda memanggil WinBioEnrollSelect dengan handel sesi asinkron, nilai pengembalian hanya menunjukkan bahwa parameter fungsi dapat diterima. Keberhasilan atau kegagalan operasi itu sendiri akan dikembalikan ke rutinitas pemberitahuan Anda dalam struktur WINBIO_ASYNC_RESULT .

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 10 [khusus aplikasi desktop]
Server minimum yang didukung	Windows Server 2016 [hanya aplikasi desktop]
Target Platform	Windows
Header	winbio.h
Pustaka	Winbio.lib
DLL	Winbio.dll