PIBIO_ENGINE_DISCARD_ENROLLMENT_FN fonction de rappel (winbio_adapter.h)
Appelé par l’infrastructure biométrique Windows pour supprimer les informations d’état d’inscription intermédiaires du pipeline.
Syntaxe
PIBIO_ENGINE_DISCARD_ENROLLMENT_FN PibioEngineDiscardEnrollmentFn;
HRESULT PibioEngineDiscardEnrollmentFn(
[in, out] PWINBIO_PIPELINE Pipeline
)
{...}
Paramètres
[in, out] Pipeline
Pointeur vers une structure WINBIO_PIPELINE associée à l’unité biométrique effectuant l’opération.
Valeur retournée
Si la fonction réussit, elle retourne S_OK. Si la fonction échoue, elle doit retourner la valeur HRESULT suivante pour indiquer l’erreur.
Code de retour | Description |
---|---|
|
Le paramètre Pipeline ne peut pas être NULL. |
Remarques
Votre implémentation de cette fonction ne doit pas enregistrer d’informations dans la base de données d’unités biométriques.
Exemples
Le pseudo-code suivant montre une implémentation possible de cette fonction. L’exemple ne se compile pas. Vous devez l’adapter à votre objectif.
//////////////////////////////////////////////////////////////////////////////////////////
//
// EngineAdapterDiscardEnrollment
//
// Purpose:
// Deletes intermediate enrollment state information from the pipeline.
//
// Parameters:
// Pipeline - Pointer to a WINBIO_PIPELINE structure associated
// with the biometric unit performing the operation
//
static HRESULT
WINAPI
EngineAdapterDiscardEnrollment(
__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 not in progress. This example assumes that
// an enrollment object is part of your engine context structure.
if (context->Enrollment.InProgress != TRUE)
{
hr = WINBIO_E_INVALID_DEVICE_STATE;
goto cleanup;
}
// Call a custom function (_AdapterDestroyEnrollmentTemplate) to release
// any objects attached to the enrollment object.
_AdapterDestroyEnrollmentTemplate(
context,
&context->Enrollment
);
// If the _AdapterDestroyEnrollmentTemplate function does not reset the
// InProgress data member, reset it here.
context->Enrollment.InProgress = FALSE;
cleanup:
return hr;
}
Configuration requise
Client minimal pris en charge | Windows 7 [applications de bureau uniquement] |
Serveur minimal pris en charge | Windows Server 2008 R2 [applications de bureau uniquement] |
Plateforme cible | Windows |
En-tête | winbio_adapter.h (include Winbio_adapter.h) |
Voir aussi
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour