ホーム › Devices.BiometricFramework › PIBIO_ENGINE_QUERY_EXTENDED_ENROLLMENT_STATUS_FN

PIBIO_ENGINE_QUERY_EXTENDED_ENROLLMENT_STATUS_FN

コールバック

シグネチャ

HRESULT PIBIO_ENGINE_QUERY_EXTENDED_ENROLLMENT_STATUS_FN(
    WINBIO_PIPELINE* Pipeline,
    WINBIO_EXTENDED_ENROLLMENT_STATUS* EnrollmentStatus,
    UINT_PTR EnrollmentStatusSize
);

パラメーター

フィールド	型	説明
Pipeline	WINBIO_PIPELINE*	操作を実行するバイオメトリックユニットに関連付けられた WINBIO_PIPELINE 構造体へのポインターです。
EnrollmentStatus	WINBIO_EXTENDED_ENROLLMENT_STATUS*	この関数が返す拡張登録ステータス情報を格納する WINBIO_EXTENDED_ENROLLMENT_STATUS 構造体へのポインターです。
EnrollmentStatusSize	UINT_PTR	拡張登録ステータス情報の指定されたサイズ (バイト単位)。

公式ドキュメント

クライアントアプリケーションが WINBIO_PROPERTY_EXTENDED_ENROLLMENT_STATUS プロパティを照会したときに、Windows Biometric Framework によって呼び出されます。

戻り値

関数が成功した場合は S_OK を返します。関数が失敗した場合は、エラーを示すために次のいずれかの HRESULT 値を返す必要があります。

戻り値	説明
E_POINTER	Pipeline パラメーターを NULL にすることはできません。
E_INVALIDARG	EnrollmentStatusSize パラメーターが、出力バッファーが小さすぎることを示しています。

解説(Remarks)

登録アプリケーションは、WinBioEnrollCapture 関数を呼び出すたびに、拡張登録ステータス情報を要求できます。

このルーチンが呼び出された時点でバイオメトリックユニットが登録テンプレートでない場合、エンジンアダプターは EnrollmentStatus.TemplateStatus フィールドに WINBIO_E_INVALID_OPERATION を設定し、関数の値として S_OK を返す必要があります。

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