次の方法で共有

WINBIO_EVENT構造体

  • [アーティクル]

WINBIO_EVENT構造体には、イベント通知が発生したときにコールバック ルーチンに送信される状態情報が含まれます。

構文

typedef struct _WINBIO_EVENT {
  WINBIO_EVENT_TYPE Type;
  union {
    struct {
      WINBIO_UNIT_ID       UnitId;
      WINBIO_REJECT_DETAIL RejectDetail;
    } Unclaimed;
    struct {
      WINBIO_UNIT_ID           UnitId;
      WINBIO_IDENTITY          Identity;
      WINBIO_BIOMETRIC_SUBTYPE SubFactor;
      WINBIO_REJECT_DETAIL     RejectDetail;
    } UnclaimedIdentify;
    struct {
      HRESULT ErrorCode;
    } Error;
  } Parameters;
} WINBIO_EVENT, *PWINBIO_EVENT;

メンバー

Type

発生したサービス プロバイダー イベント通知の種類を示す 値。 現在サポートされているプロバイダーは指紋センサーのみです。 このセンサーは、次のフラグをサポートしています。

WINBIO_EVENT_FP_UNCLAIMED (センサーは、アプリケーションまたは現在フォーカスがあるウィンドウによって要求されていない指のスワイプを検出しました。Windows 生体認証フレームワークはコールバック関数を呼び出して、指のスワイプが発生したが指紋の識別を試みないことを示します)。

WINBIO_EVENT_FP_UNCLAIMED_IDENTIFY (センサーは、アプリケーションまたは現在フォーカスがあるウィンドウによって要求されていない指のスワイプを検出しました。Windows 生体認証フレームワークは指紋の識別を試み、そのプロセスの結果をコールバック関数に渡します)。

パラメーター

未請求

生体認証サンプル キャプチャ用に返される構造。

UnitId

サンプルを生成した生体認証ユニット。

RejectDetail

生体認証サンプルのキャプチャ失敗に関する追加情報を含む ULONG 値。 キャプチャが成功した場合、このパラメーターは 0 に設定されます。 指紋キャプチャには、次の値が定義されています。

  • WINBIO_FP_TOO_HIGH
  • WINBIO_FP_TOO_LOW
  • WINBIO_FP_TOO_LEFT
  • WINBIO_FP_TOO_RIGHT
  • WINBIO_FP_TOO_FAST
  • WINBIO_FP_TOO_SLOW
  • WINBIO_FP_POOR_QUALITY
  • WINBIO_FP_TOO_SKEWED
  • WINBIO_FP_TOO_SHORT
  • WINBIO_FP_MERGE_FAILURE

UnclaimedIdentify

生体認証キャプチャと識別のために返される構造。 識別は、サンプルを既存の生体認証テンプレートに関連付けることができるかどうかを決定します。

UnitId

サンプルを生成した生体認証ユニット。

ID

生体認証サンプルを提供するユーザーの GUID または SID を含む WINBIO_IDENTITY 構造体。

SubFactor

生体認証サンプルに関連付けられているサブ要素を指定する WINBIO_BIOMETRIC_SUBTYPE 値。 現在、Windows 生体認証フレームワーク (WBF) は指紋キャプチャのみをサポートしており、次の定数を使用してサブタイプ情報を表します。

  • WINBIO_ANSI_381_POS_UNKNOWN
  • WINBIO_ANSI_381_POS_RH_THUMB
  • WINBIO_ANSI_381_POS_RH_INDEX_FINGER
  • WINBIO_ANSI_381_POS_RH_MIDDLE_FINGER
  • WINBIO_ANSI_381_POS_RH_RING_FINGER
  • WINBIO_ANSI_381_POS_RH_LITTLE_FINGER
  • WINBIO_ANSI_381_POS_LH_THUMB
  • WINBIO_ANSI_381_POS_LH_INDEX_FINGER
  • WINBIO_ANSI_381_POS_LH_MIDDLE_FINGER
  • WINBIO_ANSI_381_POS_LH_RING_FINGER
  • WINBIO_ANSI_381_POS_LH_LITTLE_FINGER
  • WINBIO_ANSI_381_POS_RH_FOUR_FINGERS
  • WINBIO_ANSI_381_POS_LH_FOUR_FINGERS
  • WINBIO_ANSI_381_POS_TWO_THUMBS

重要

SubFactor 値に指定された値の検証を試みないでください。 Windows 生体認証サービスは、指定された値を実装に渡す前に検証します。 値が WINBIO_SUBTYPE_NO_INFORMATION または WINBIO_SUBTYPE_ANY場合は、必要に応じて検証します。

RejectDetail

生体認証サンプルのキャプチャ失敗に関する追加情報を含む ULONG 値。 キャプチャが成功した場合、このパラメーターは 0 に設定されます。 指紋キャプチャには、次の値が定義されています。

  • WINBIO_FP_TOO_HIGH
  • WINBIO_FP_TOO_LOW
  • WINBIO_FP_TOO_LEFT
  • WINBIO_FP_TOO_RIGHT
  • WINBIO_FP_TOO_FAST
  • WINBIO_FP_TOO_SLOW
  • WINBIO_FP_POOR_QUALITY
  • WINBIO_FP_TOO_SKEWED
  • WINBIO_FP_TOO_SHORT
  • WINBIO_FP_MERGE_FAILURE

Error

監視対象の操作の成功または失敗を識別する構造体。

ErrorCode

S_OKまたは Windows 生体認証フレームワークによって実行された計算の結果として発生したエラー コードを含む HRESULT 値。

解説

WinBioRegisterEventMonitor 関数を呼び出して、Windows 生体認証フレームワークからイベント通知を受信するコールバック ルーチンを登録します。 コールバックは、アプリケーション用に定義する必要があるカスタム関数です。

要件

要件 値
サポートされている最小のクライアント
 Windows 7 [デスクトップ アプリのみ]
サポートされている最小のサーバー
 Windows Server 2008 R2 [デスクトップ アプリのみ]
Header
Winbio_types.h (Winbio.h を含む)

関連項目

クライアント アプリケーションの構造

WinBioRegisterEventMonitor