функция обратного вызова PIBIO_ENGINE_CREATE_KEY_FN (winbio_adapter.h)

Вызывается платформой Биометрических данных Windows для отправки ключа HMAC на датчик. Возвращенный идентификатор ключа будет передан обратно в биометрическую единицу, когда платформа вызывает EngineAdapterIdentifyFeatureSetSecure.

Синтаксис

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

Параметры

Pipeline

Указатель на WINBIO_PIPELINE структуру, связанную с биометрической единицей, выполняющей операцию.

Key

Указатель на буфер, содержащий ключ HMAC.

KeySize

Размер буфера, заданного параметром Key , в байтах.

KeyIdentifier

Указатель на буфер, получающий идентификатор ключа. Формат буфера определяется поставщиком.

KeyIdentifierSize

Размер (в байтах) буфера, заданного параметром KeyIdentifier .

ResultSize

Указатель на переменную, которая получает размер (в байтах) данных, записанных в буфер, заданный параметром KeyIdentifier .

Возвращаемое значение

Если буфер KeyIdentifier слишком мал, необходимо вернуть WINBIO_E_KEY_IDENTIFIER_BUFFER_TOO_SMALL , а требуемый размер должен быть записан в ResultSize. Платформа снова вызовет API с большим буфером. Если датчик не может создать ключ, необходимо вернуть WINBIO_E_KEY_CREATION_FAILED .

Комментарии

В любое время будет использоваться только один ключ. Если EngineAdapterCreateKey вызывается, когда подсистеме известно о ранее существовавом ключе, существующий ключ должен быть перезаписан новым.

Требования

Требование	Значение
Минимальная версия клиента	Windows 10 [только классические приложения]
Минимальная версия сервера	Windows Server 2016 [только классические приложения]
Целевая платформа	Windows
Header	winbio_adapter.h (включая Winbio_adapter.h)