PIBIO_ENGINE_CREATE_KEY_FN función de devolución de llamada (winbio_adapter.h)

Lo llama Windows Biometric Framework para insertar una clave HMAC en el sensor. El identificador de clave devuelto se devolverá a la unidad biométrica cuando el marco llame a EngineAdapterIdentifyFeatureSetSecure.

Sintaxis

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

Parámetros

Pipeline

Puntero a una estructura de WINBIO_PIPELINE asociada a la unidad biométrica que realiza la operación.

Key

Puntero a un búfer que contiene la clave HMAC.

KeySize

Tamaño, en bytes, del búfer especificado por el parámetro Key .

KeyIdentifier

Puntero a un búfer que recibe un identificador de clave. El formato del búfer está definido por el proveedor.

KeyIdentifierSize

Tamaño, en bytes, del búfer especificado por el parámetro KeyIdentifier .

ResultSize

Puntero a una variable que recibe el tamaño, en bytes, de los datos escritos en el búfer especificado por el parámetro KeyIdentifier .

Valor devuelto

Si el búfer KeyIdentifier es demasiado pequeño, se debe devolver WINBIO_E_KEY_IDENTIFIER_BUFFER_TOO_SMALL y se debe escribir el tamaño necesario en ResultSize. El marco llamará a la API de nuevo con un búfer mayor. Si el sensor no puede crear la clave, se debe devolver WINBIO_E_KEY_CREATION_FAILED .

Comentarios

Solo se usará una sola clave en cualquier momento. Si se llama a EngineAdapterCreateKey cuando el motor conoce una clave preexistente, la clave preexistente debe sobrescribirse con la nueva.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 10 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2016 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	winbio_adapter.h (incluya Winbio_adapter.h)