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 ，則必須以新的密鑰覆寫預先存在的密鑰。

規格需求