fungsi panggilan balik PIBIO_ENGINE_CREATE_ENROLLMENT_FN (winbio_adapter.h)
Dipanggil oleh Windows Biometric Framework untuk menginisialisasi objek pendaftaran dalam alur unit biometrik.
Sintaks
PIBIO_ENGINE_CREATE_ENROLLMENT_FN PibioEngineCreateEnrollmentFn;
HRESULT PibioEngineCreateEnrollmentFn(
[in, out] PWINBIO_PIPELINE Pipeline
)
{...}
Parameter
[in, out] Pipeline
Penunjuk ke struktur WINBIO_PIPELINE yang terkait dengan unit biometrik yang melakukan operasi.
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 |
---|---|
|
Parameter Alur tidak boleh NULL. |
|
Tidak ada cukup memori untuk menyelesaikan operasi. |
Keterangan
EngineAdapterCommitEnrollment menandai awal transaksi pendaftaran. Jika fungsi ini berhasil, Windows Biometric Framework memanggil EngineAdapterUpdateEnrollment untuk menambahkan satu atau beberapa set fitur ke objek pendaftaran. Framework kemudian memanggil EngineAdapterCommitEnrollment atau EngineAdapterDiscardEnrollment untuk menyelesaikan transaksi.
Contoh
Pseudocode berikut menunjukkan satu kemungkinan implementasi fungsi ini. Contoh tidak dikompilasi. Anda harus menyesuaikannya agar sesuai dengan tujuan Anda.
//////////////////////////////////////////////////////////////////////////////////////////
//
// EngineAdapterCreateEnrollment
//
// Purpose:
// Initialize the enrollment object in the biometric unit pipeline.
//
// Parameters:
// Pipeline - Pointer to a WINBIO_PIPELINE structure associated
// with the biometric unit performing the operation
//
static HRESULT
WINAPI
EngineAdapterCreateEnrollment(
__inout PWINBIO_PIPELINE Pipeline
)
{
HRESULT hr = S_OK;
// Verify that the Pipeline parameter is not NULL.
if (!ARGUMENT_PRESENT(Pipeline))
{
hr = E_POINTER;
goto cleanup;
}
// Retrieve the context from the pipeline.
PWINBIO_ENGINE_CONTEXT context =
(PWINBIO_ENGINE_CONTEXT)Pipeline->EngineContext;
// Return if an enrollment is already in progress. This example assumes that
// your engine adapter context contains an enrollment object.
if (context->Enrollment.InProgress == TRUE)
{
hr = WINBIO_E_INVALID_DEVICE_STATE;
goto cleanup;
}
// Call a custom function (_AdapterCreateEnrollmentTemplate) to create a
// new enrollment template and attach it to the engine adapter context.
hr = _AdapterCreateEnrollmentTemplate(
context,
&context->Enrollment
);
if (FAILED(hr))
{
goto cleanup;
}
// Initialize any Enrollment data members not initialized by the
// _AdapterCreateEnrollmentTemplate function. This example assumes that
// your enrollment object contains at a minimum a field that specifies
// the number of biometric samples and another that specifies whether a
// new enrollment is in progress.
context->Enrollment.SampleCount = 0;
context->Enrollment.InProgress = TRUE;
cleanup:
return hr;
}
Persyaratan
Persyaratan | Nilai |
---|---|
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_adapter.h (termasuk Winbio_adapter.h) |
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk