PIBIO_ENGINE_CREATE_KEY_FN コールバック関数 (winbio_adapter.h)

HMAC キーをセンサーにプッシュするために、Windows 生体認証フレームワークによって呼び出されます。 フレームワークが 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 を返す必要があります。

注釈

いつでも 1 つのキーのみが使用されます。 エンジンに既存のキーの知識があるときに EngineAdapterCreateKey が呼び出される場合は、既存のキーを新しいキーで上書きする必要があります。

要件