Fungsi WinBioAsyncEnumBiometricUnits (winbio.h)

  • Artikel

Secara asinkron menghitung semua unit biometrik yang terpasang yang cocok dengan jenis faktor input. Untuk versi sinkron fungsi ini, lihat WinBioEnumBiometricUnits. Dimulai dengan Windows 10, build 1607, fungsi ini tersedia untuk digunakan dengan gambar seluler.

Sintaks

HRESULT WinBioAsyncEnumBiometricUnits(
  [in] WINBIO_FRAMEWORK_HANDLE FrameworkHandle,
  [in] WINBIO_BIOMETRIC_TYPE   Factor
);

Parameter

[in] FrameworkHandle

Tangani ke sesi kerangka kerja yang dibuka dengan memanggil WinBioAsyncOpenFramework.

[in] Factor

Bitmask bendera WINBIO_BIOMETRIC_TYPE yang menentukan jenis unit biometrik yang akan dijumlahkan. Hanya WINBIO_TYPE_FINGERPRINT yang saat ini didukung.

Menampilkan nilai

Fungsi mengembalikan HRESULT yang menunjukkan keberhasilan atau kegagalan. Perhatikan bahwa keberhasilan hanya menunjukkan bahwa argumen valid. Kegagalan yang dihadapi selama eksekusi operasi akan dikembalikan secara asinkron ke struktur WINBIO_ASYNC_RESULT menggunakan metode pemberitahuan yang ditentukan dalam panggilan ke WinBioAsyncOpenFramework.

Menampilkan kode Deskripsi
E_HANDLE
 Anda harus mengatur argumen FrameworkHandle .
E_INVALIDARG
 Bitmask yang terkandung dalam parameter Factor berisi satu atau beberapa bit jenis yang tidak valid.
E_OUTOFMEMORY
 Memori tidak cukup untuk menyelesaikan permintaan.
WINBIO_E_DISABLED
 Kebijakan administratif saat ini melarang penggunaan WINDOWS Biometric Framework API.
WINBIO_E_INCORRECT_SESSION_TYPE
 Argumen FrameworkHandle harus mewakili sesi kerangka kerja asinkron.
WINBIO_E_SESSION_HANDLE_CLOSED
 Handel sesi telah ditandai untuk penutupan.

Keterangan

Fungsi WinBioAsyncEnumBiometricUnits menggunakan handel ke sesi kerangka kerja yang dibuka dengan memanggil WinBioAsyncOpenFramework. Kerangka kerja mengalokasikan struktur WINBIO_ASYNC_RESULT dan menggunakannya untuk mengembalikan informasi tentang keberhasilan atau kegagalan operasi. Jika operasi enumerasi berhasil, kerangka kerja mengembalikan array skema yang menyertakan informasi tentang setiap unit biometrik yang dijumlahkan. Jika operasi tidak berhasil, kerangka kerja menggunakan struktur WINBIO_ASYNC_RESULT untuk mengembalikan informasi kesalahan. Struktur dikembalikan ke panggilan balik aplikasi atau ke antrean pesan aplikasi, tergantung pada nilai yang Anda tetapkan dalam parameter NotificationMethod dari fungsi WinBioAsyncOpenFramework .

  • Jika Anda memilih untuk menerima pemberitahuan penyelesaian dengan menggunakan panggilan balik, Anda harus menerapkan fungsi PWINBIO_ASYNC_COMPLETION_CALLBACK dan mengatur parameter NotificationMethod ke WINBIO_ASYNC_NOTIFY_CALLBACK.
  • Jika Anda memilih untuk menerima pemberitahuan penyelesaian dengan menggunakan antrean pesan aplikasi, Anda harus mengatur parameter NotificationMethod ke WINBIO_ASYNC_NOTIFY_MESSAGE. Kerangka kerja mengembalikan penunjuk WINBIO_ASYNC_RESULT ke bidang LPARAM dari pesan jendela.
Array skema dikembalikan dalam struktur EnumBiometricUnits yang bersarang di dalam struktur WINBIO_ASYNC_RESULT . Anda harus memanggil WinBioFree untuk merilis struktur WINBIO_ASYNC_RESULT setelah Anda selesai menggunakannya.

Memanggil WinBioAsyncEnumBiometricUnits menyebabkan satu pemberitahuan dikirim ke aplikasi klien.

Persyaratan

   
Klien minimum yang didukung Windows 8 [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2012 [hanya aplikasi desktop]
Target Platform Windows
Header winbio.h (termasuk Winbio.h)
Pustaka Winbio.lib
DLL Winbio.dll

Lihat juga

WinBioAsyncOpenFramework