Fungsi WinBioAsyncMonitorFrameworkChanges (winbio.h)

  • Artikel

Memulai pemantauan asinkron perubahan pada kerangka kerja biometrik. Saat ini, satu-satunya perubahan terpantau yang didukung terjadi ketika unit biometrik dilampirkan atau dilepas dari komputer.

Sintaks

HRESULT WinBioAsyncMonitorFrameworkChanges(
  [in] WINBIO_FRAMEWORK_HANDLE      FrameworkHandle,
  [in] WINBIO_FRAMEWORK_CHANGE_TYPE ChangeTypes
);

Parameter

[in] FrameworkHandle

Tangani ke sesi kerangka kerja yang dibuka dengan memanggil WinBioAsyncOpenFramework.

[in] ChangeTypes

Bitmask jenis WINBIO_FRAMEWORK_CHANGE_TYPE bendera yang menunjukkan jenis peristiwa yang harus menghasilkan pemberitahuan asinkron. Dimulai dengan Windows 8, bendera berikut tersedia:

Nilai Makna
WINBIO_FRAMEWORK_CHANGE_UNIT
 Unit biometrik telah dilampirkan atau dilepas dari komputer.

Nilai kembali

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 WinBioAsyncOpenFramework.

Menampilkan kode Deskripsi
E_HANDLE
 Anda harus mengatur argumen FrameworkHandle .
E_INVALIDARG
 Bitmask yang terkandung dalam parameter ChangeTypes berisi satu atau beberapa bit jenis yang tidak valid. Saat ini, satu-satunya nilai yang tersedia adalah WINBIO_FRAMEWORK_CHANGE_UNIT.
WINBIO_E_INCORRECT_SESSION_TYPE
 Argumen FrameworkHandle harus mewakili sesi kerangka kerja asinkron.

Keterangan

Setelah dimulai, monitor ini akan terus menghasilkan peristiwa sampai aplikasi klien memanggil WinBioCancel atau WinBioCloseFramework. Membuat monitor untuk peristiwa WINBIO_FRAMEWORK_CHANGE_UNIT akan menghasilkan dua jenis pemberitahuan asinkron:

Nilai Makna
WINBIO_OPERATION_UNIT_ARRIVAL Unit biometrik terpasang.
WINBIO_OPERATION_UNIT_REMOVAL Unit biometrik dilepaskan.
 

Fungsi WinBioAsyncMonitorFrameworkChanges 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 unit biometrik dilampirkan atau dilepas dari komputer, kerangka kerja menetapkan anggota Operasi struktur. Jika masalah ditemui selama operasi, 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.
Pemberitahuan dikembalikan dalam struktur EnumServiceProviders yang berlapis di dalam struktur WINBIO_ASYNC_RESULT . Anda harus memanggil WinBioFree untuk merilis struktur WINBIO_ASYNC_RESULT setelah Anda selesai menggunakannya.

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