ホーム › Devices.BiometricFramework › PIBIO_ENGINE_CREATE_KEY_FN

PIBIO_ENGINE_CREATE_KEY_FN

コールバック

シグネチャ

HRESULT PIBIO_ENGINE_CREATE_KEY_FN(
    WINBIO_PIPELINE* Pipeline,
    BYTE* Key,
    UINT_PTR KeySize,
    BYTE* KeyIdentifier,
    UINT_PTR KeyIdentifierSize,
    UINT_PTR* ResultSize
);

パラメーター

フィールド	型	説明
Pipeline	WINBIO_PIPELINE*	操作を実行するバイオメトリックユニットに関連付けられた WINBIO_PIPELINE 構造体へのポインターです。
Key	BYTE*	HMAC キーを格納するバッファーへのポインターです。
KeySize	UINT_PTR	Key パラメーターで指定されたバッファーのサイズ (バイト単位)。
KeyIdentifier	BYTE*	キー識別子を受け取るバッファーへのポインターです。バッファーの形式はベンダー定義です。
KeyIdentifierSize	UINT_PTR	KeyIdentifier パラメーターで指定されたバッファーのサイズ (バイト単位)。
ResultSize	UINT_PTR*	KeyIdentifier パラメーターで指定されたバッファーに書き込まれたデータのサイズ (バイト単位) を受け取る変数へのポインターです。

公式ドキュメント

HMAC キーをセンサーにプッシュするために、Windows Biometric Framework によって呼び出されます。返されたキー識別子は、フレームワークが EngineAdapterIdentifyFeatureSetSecure を呼び出すときにバイオメトリックユニットに渡されます。

戻り値

KeyIdentifier バッファーが小さすぎる場合は、WINBIO_E_KEY_IDENTIFIER_BUFFER_TOO_SMALL を返し、必要なサイズを ResultSize に書き込む必要があります。フレームワークは、より大きなバッファーを指定して API を再度呼び出します。センサーがキーを作成できない場合は、WINBIO_E_KEY_CREATION_FAILED を返す必要があります。

解説(Remarks)

一度に使用されるキーは 1 つだけです。エンジンが既存のキーを認識している状態で EngineAdapterCreateKey が呼び出された場合、既存のキーは新しいキーで上書きする必要があります。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)