fungsi panggilan balik PIBIO_ENGINE_CREATE_KEY_FN (winbio_adapter.h)

Artikel
03/13/2024

Dipanggil oleh Windows Biometric Framework untuk mendorong kunci HMAC ke sensor. Pengidentifikasi kunci yang dikembalikan akan diteruskan kembali ke unit biometrik ketika kerangka kerja memanggil EngineAdapterIdentifyFeatureSetSecure.

Sintaks

PIBIO_ENGINE_CREATE_KEY_FN PibioEngineCreateKeyFn;

HRESULT PibioEngineCreateKeyFn(
  PWINBIO_PIPELINE Pipeline,
  const UCHAR *Key,
  SIZE_T KeySize,
  PUCHAR KeyIdentifier,
  SIZE_T KeyIdentifierSize,
  PSIZE_T ResultSize
)
{...}

Parameter

Pipeline

Penunjuk ke struktur WINBIO_PIPELINE yang terkait dengan unit biometrik yang melakukan operasi.

Key

Penunjuk ke buffer yang berisi kunci HMAC.

KeySize

Ukuran, dalam byte, dari buffer yang ditentukan oleh parameter Kunci .

KeyIdentifier

Penunjuk ke buffer yang menerima pengidentifikasi kunci. Format buffer ditentukan vendor.

KeyIdentifierSize

Ukuran, dalam byte, dari buffer yang ditentukan oleh parameter KeyIdentifier .

ResultSize

Penunjuk ke variabel yang menerima ukuran, dalam byte, dari data yang ditulis ke buffer yang ditentukan oleh parameter KeyIdentifier .

Nilai kembali

Jika buffer KeyIdentifier terlalu kecil, WINBIO_E_KEY_IDENTIFIER_BUFFER_TOO_SMALL harus dikembalikan, dan ukuran yang diperlukan harus ditulis ke ResultSize. Kerangka kerja akan memanggil API lagi dengan buffer yang lebih besar. Jika sensor tidak dapat membuat kunci, WINBIO_E_KEY_CREATION_FAILED harus dikembalikan.

Keterangan

Hanya satu kunci yang akan digunakan kapan saja. Jika EngineAdapterCreateKey dipanggil ketika mesin memiliki pengetahuan tentang kunci yang sudah ada sebelumnya, kunci yang sudah ada sebelumnya harus ditimpa dengan yang baru.

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_adapter.h (termasuk Winbio_adapter.h)

Bagikan melalui