Fungsi WinBioOpenSession (winbio.h)

Artikel
03/08/2023

Terhubung ke penyedia layanan biometrik dan satu atau beberapa unit biometrik.

Sintaks

HRESULT WinBioOpenSession(
  [in]  WINBIO_BIOMETRIC_TYPE Factor,
  [in]  WINBIO_POOL_TYPE      PoolType,
  [in]  WINBIO_SESSION_FLAGS  Flags,
  [in]  WINBIO_UNIT_ID        *UnitArray,
  [in]  SIZE_T                UnitCount,
  [in]  GUID                  *DatabaseId,
  [out] WINBIO_SESSION_HANDLE *SessionHandle
);

Parameter

[in] Factor

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

[in] PoolType

Nilai ULONG yang menentukan jenis unit biometrik yang akan digunakan dalam sesi. Ini bisa menjadi salah satu nilai berikut:

Nilai	Makna
WINBIO_POOL_SYSTEM	Sesi ini terhubung ke koleksi bersama unit biometrik yang dikelola oleh penyedia layanan.
WINBIO_POOL_PRIVATE	Sesi ini terhubung ke kumpulan unit biometrik yang dikelola oleh pemanggil.

[in] Flags

Nilai ULONG yang menentukan konfigurasi unit biometrik dan karakteristik akses untuk sesi baru. Bendera konfigurasi menentukan konfigurasi umum unit dalam sesi. Bendera akses menentukan bagaimana aplikasi akan menggunakan unit biometrik. Anda harus menentukan satu bendera konfigurasi tetapi Anda dapat menggabungkan bendera tersebut dengan bendera akses apa pun.

Nilai	Makna
WINBIO_FLAG_DEFAULT	Grup: konfigurasi Unit biometrik beroperasi dengan cara yang ditentukan selama penginstalan. Anda harus menggunakan nilai ini ketika parameter PoolType WINBIO_POOL_SYSTEM.
WINBIO_FLAG_BASIC	Grup: konfigurasi Unit biometrik hanya beroperasi sebagai perangkat penangkapan dasar. Semua operasi pemrosesan, pencocokan, dan penyimpanan dilakukan oleh plug-in perangkat lunak.
WINBIO_FLAG_ADVANCED	Grup: konfigurasi Unit biometrik menggunakan kemampuan pemrosesan dan penyimpanan internal.
WINBIO_FLAG_RAW	Grup: akses Aplikasi klien menangkap data biometrik mentah menggunakan WinBioCaptureSample.
WINBIO_FLAG_MAINTENANCE	Grup: akses Klien melakukan operasi kontrol yang ditentukan vendor pada unit biometrik dengan memanggil WinBioControlUnitPrivileged.

[in] UnitArray

Penunjuk ke array pengidentifikasi unit biometrik yang akan disertakan dalam sesi. Anda dapat memanggil WinBioEnumBiometricUnits untuk menghitung unit biometrik. Atur nilai ini ke NULL jika parameter PoolTypeWINBIO_POOL_SYSTEM.

[in] UnitCount

Nilai yang menentukan jumlah elemen dalam array yang diarahkan oleh parameter UnitArray . Atur nilai ini ke nol jika parameter PoolTypeWINBIO_POOL_SYSTEM.

[in] DatabaseId

Nilai yang menentukan database yang akan digunakan oleh sesi. Jika parameter PoolTypeWINBIO_POOL_PRIVATE, Anda harus menentukan GUID database yang diinstal. Jika parameter PoolType tidak WINBIO_POOL_PRIVATE, Anda dapat menentukan salah satu nilai umum berikut.

Nilai	Makna
WINBIO_DB_DEFAULT	Setiap unit biometrik di kumpulan sensor menggunakan database default yang ditentukan dalam konfigurasi unit biometrik default. Anda harus menentukan nilai ini jika parameter PoolTypeWINBIO_POOL_SYSTEM. Anda tidak dapat menggunakan nilai ini jika parameter PoolTypeWINBIO_POOL_PRIVATE
WINBIO_DB_BOOTSTRAP	Anda dapat menentukan nilai ini yang akan digunakan untuk skenario sebelum memulai Windows. Biasanya, database adalah bagian dari chip sensor atau merupakan bagian dari BIOS dan hanya dapat digunakan untuk pendaftaran dan penghapusan templat.
WINBIO_DB_ONCHIP	Database ada di chip sensor dan tersedia untuk pendaftaran dan pencocokan.

[out] SessionHandle

Arahkan ke handel sesi baru. Jika fungsi tidak berhasil, handel diatur ke nol.

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_INVALIDARG	Satu atau beberapa argumen memiliki nilai yang salah atau tidak kompatibel dengan argumen lain.
E_POINTER	Penunjuk handel sesi dalam parameter SessionHandle tidak boleh NULL.
E_ACCESSDENIED	Parameter Bendera berisi WINBIO_FLAG_RAW atau bendera WINBIO_FLAG_MAINTENANCE dan pemanggil belum diberikan izin akses.
WINBIO_E_INVALID_UNIT	Satu atau beberapa nomor unit biometrik yang ditentukan dalam parameter UnitArray tidak valid.
WINBIO_E_NOT_ACTIVE_CONSOLE	Aplikasi klien berjalan pada klien desktop jarak jauh dan mencoba membuka sesi kumpulan sistem.
WINBIO_E_SENSOR_UNAVAILABLE	Parameter PoolType diatur ke WINBIO_POOL_PRIVATE dan satu atau beberapa sensor yang diminta di kumpulan tersebut tidak tersedia.
WINBIO_E_DISABLED	Kebijakan administratif saat ini melarang penggunaan Windows Biometric Framework API.

Persyaratan


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

WinBioCloseSession

Bagikan melalui