PIBIO_ENGINE_CREATE_KEY_FN funzione di callback (winbio_adapter.h)

Chiamato da Windows Biometric Framework per eseguire il push di una chiave HMAC nel sensore. L'identificatore di chiave restituito verrà passato all'unità biometrica quando il framework chiama EngineAdapterIdentifyFeatureSetSecure.

Sintassi

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

Parametri

Pipeline

Puntatore a una struttura WINBIO_PIPELINE associata all'unità biometrica che esegue l'operazione.

Key

Puntatore a un buffer contenente la chiave HMAC.

KeySize

Dimensioni, in byte, del buffer specificato dal parametro Key .

KeyIdentifier

Puntatore a un buffer che riceve un identificatore di chiave. Il formato del buffer è definito dal fornitore.

KeyIdentifierSize

Dimensioni, in byte, del buffer specificato dal parametro KeyIdentifier .

ResultSize

Puntatore a una variabile che riceve le dimensioni, in byte, dei dati scritti nel buffer specificato dal parametro KeyIdentifier .

Valore restituito

Se il buffer KeyIdentifier è troppo piccolo, WINBIO_E_KEY_IDENTIFIER_BUFFER_TOO_SMALL deve essere restituito e le dimensioni necessarie devono essere scritte in ResultSize. Il framework chiamerà di nuovo l'API con un buffer più grande. Se il sensore non riesce a creare la chiave, WINBIO_E_KEY_CREATION_FAILED deve essere restituito.

Commenti

In qualsiasi momento verrà usata solo una sola chiave. Se EngineAdapterCreateKey viene chiamato quando il motore conosce una chiave preesistente, la chiave preesistente deve essere sovrascritta con quella nuova.

Requisiti