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
标头 winbio_adapter.h (包括 Winbio_adapter.h)