PIBIO_ENGINE_CREATE_KEY_FN fonction de rappel (winbio_adapter.h)

Article
08/27/2023

Appelé par l’infrastructure biométrique Windows pour envoyer (push) une clé HMAC au capteur. L’identificateur de clé retourné est repassé à l’unité biométrique lorsque l’infrastructure appelle EngineAdapterIdentifyFeatureSetSecure.

Syntaxe

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
)
{...}

Paramètres

Pipeline

Pointeur vers une structure WINBIO_PIPELINE associée à l’unité biométrique effectuant l’opération.

Key

Pointeur vers une mémoire tampon qui contient la clé HMAC.

KeySize

Taille, en octets, de la mémoire tampon spécifiée par le paramètre Key .

KeyIdentifier

Pointeur vers une mémoire tampon qui reçoit un identificateur de clé. Le format de la mémoire tampon est défini par le fournisseur.

KeyIdentifierSize

Taille, en octets, de la mémoire tampon spécifiée par le paramètre KeyIdentifier .

ResultSize

Pointeur vers une variable qui reçoit la taille, en octets, des données écrites dans la mémoire tampon spécifiée par le paramètre KeyIdentifier .

Valeur retournée

Si la mémoire tampon KeyIdentifier est trop petite, WINBIO_E_KEY_IDENTIFIER_BUFFER_TOO_SMALL doit être retourné et la taille requise doit être écrite dans ResultSize. Le framework appelle à nouveau l’API avec une mémoire tampon plus grande. Si le capteur ne peut pas créer la clé, WINBIO_E_KEY_CREATION_FAILED doit être retournée.

Remarques

Une seule clé sera utilisée à tout moment. Si EngineAdapterCreateKey est appelé lorsque le moteur a connaissance d’une clé préexistante, la clé préexistante doit être remplacée par la nouvelle.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 10 (applications de bureau uniquement)
Serveur minimal pris en charge	Windows Server 2016 (applications de bureau uniquement)
Plateforme cible	Windows
En-tête	winbio_adapter.h (include Winbio_adapter.h)

Partager via