Fungsi WinBioAsyncEnumDatabases (winbio.h)

Secara asinkron menghitung semua database terdaftar yang cocok dengan jenis tertentu. Untuk versi sinkron fungsi ini, lihat WinBioEnumDatabases.

Sintaks

HRESULT WinBioAsyncEnumDatabases(
  [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 database biometrik yang akan dijumlahkan. Hanya WINBIO_TYPE_FINGERPRINT yang saat ini didukung.

Mengembalikan nilai

Fungsi mengembalikan HRESULT yang menunjukkan keberhasilan atau kegagalan. Perhatikan bahwa keberhasilan hanya menunjukkan bahwa argumen fungsi 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_INCORRECT_SESSION_TYPE	Argumen FrameworkHandle harus mewakili sesi kerangka kerja asinkron.

Keterangan

Fungsi WinBioAsyncEnumDatabases 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 database 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 EnumDatabases yang ditumpuk di dalam struktur WINBIO_ASYNC_RESULT . Anda harus memanggil WinBioFree untuk merilis struktur WINBIO_ASYNC_RESULT setelah Anda selesai menggunakannya.

Memanggil WinBioAsyncEnumDatabases menyebabkan satu pemberitahuan dikirim ke aplikasi klien.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8 [khusus 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