PIBIO_ENGINE_SET_ACCOUNT_POLICY_FN fungsi panggilan balik (winbio_adapter.h)

Artikel
03/13/2024

Dipanggil oleh Windows Biometric Framework untuk mengatur kebijakan antispoofing default dan per pengguna yang diperluas yang digunakan oleh adaptor mesin.

Sintaks

PIBIO_ENGINE_SET_ACCOUNT_POLICY_FN PibioEngineSetAccountPolicyFn;

HRESULT PibioEngineSetAccountPolicyFn(
  [in, out] PWINBIO_PIPELINE Pipeline,
  [in]      PWINBIO_ACCOUNT_POLICY PolicyItemArray,
  [in]      SIZE_T PolicyItemCount
)
{...}

Parameter

[in, out] Pipeline

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

[in] PolicyItemArray

Alamat array struktur WINBIO_ACCOUNT_POLICY , yang harus digunakan rutinitas untuk memperbarui kebijakan yang diterapkannya ke identitas apa pun yang dideteksinya.

[in] PolicyItemCount

Jumlah elemen dalam array yang diarahkan oleh parameter PolicyItemArray .

Mengembalikan nilai

Jika fungsi berhasil, fungsi akan mengembalikan S_OK. Jika fungsi gagal, fungsi harus mengembalikan salah satu nilai HRESULT berikut untuk menunjukkan kesalahan.

Menampilkan kode	Deskripsi
E_some_error	Kesalahan yang dikembalikan oleh metode dicatat tetapi diabaikan.

Keterangan

Metode ini dipanggil setiap kali unit biometrik diaktifkan.

Metode ini dijalankan dalam konteks utas yang sama yang mengaktifkan unit biometrik dan yang memproses semua permintaan lain untuk unit tersebut.

Bidang Identity.Type dari elemen pertama dalam PolicyItemArray akan selalu WINBIO_ID_TYPE_WILDCARD. Ini menunjukkan bahwa item kebijakan berisi nilai AntiSpoofBehavior default yang harus diterapkan ke akun pengguna apa pun yang tidak secara eksplisit tercantum di array lainnya.

Jika PolicyItemArray berisi lebih dari satu elemen, bidang Identity.Type dari item yang tersisa akan WINBIO_ID_TYPE_WILDCARD, dan bidang Identity.Value.AccountSid.Data akan berisi SID akun pengguna yang memerlukan perilaku kebijakan antispoof yang ditentukan dalam bidang AntiSpoofBehavior dari elemen array.

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