PWINBIO_LOCATE_SENSOR_CALLBACK コールバック関数 (winbio.h)

  • [アーティクル]

非同期 WinBioLocateSensorWithCallback 関数から結果を返すために、Windows 生体認証フレームワークによって呼び出されます。 クライアント アプリケーションでは、この関数を実装する必要があります。

大事なWindows 8 以降では、winBioLocateSensorWithCallbackの組み合わせPWINBIO_LOCATE_SENSOR_CALLBACK/を使用しなくなります。 代わりに、次の操作を行います。
  • 操作が完了したときに通知を受け取る PWINBIO_ASYNC_COMPLETION_CALLBACK 関数を実装します。
  • WinBioAsyncOpenSession 関数を呼び出します。 CallbackRoutine パラメーターでコールバックのアドレスを渡します。 NotificationMethod パラメーターにWINBIO_ASYNC_NOTIFY_CALLBACKを渡します。 非同期セッション ハンドルを取得します。
  • 非同期セッション ハンドルを使用して WinBioLocateSensor を呼び出します。 操作が完了すると、Windows 生体認証フレームワークは、結果を 使用してWINBIO_ASYNC_RESULT 構造体を割り当てて初期化し、結果構造へのポインターを使用してコールバックを呼び出します。
  • コールバック実装から WinBioFree を呼び出して、 WINBIO_ASYNC_RESULT 構造体の使用が完了した後で解放します。
 

構文

PWINBIO_LOCATE_SENSOR_CALLBACK PwinbioLocateSensorCallback;

void PwinbioLocateSensorCallback(
  [in, optional] PVOID LocateCallbackContext,
  [in]           HRESULT OperationStatus,
                 WINBIO_UNIT_ID UnitId
)
{...}

パラメーター

[in, optional] LocateCallbackContext

アプリケーションによって定義され、WinBioLocateSensorWithCallback 関数の LocateCallbackContext パラメーターに渡されるバッファーへのポインター。 バッファーは、フレームワークまたは生体認証ユニットによって変更されません。 アプリケーションでは、データを使用して、実行するアクションを特定したり、生体認証キャプチャに関する追加情報を保持したりできます。

[in] OperationStatus

キャプチャ操作によって返されるエラー コード。

UnitId

生体認証ユニット ID 番号。

戻り値

なし

必要条件

要件 値
サポートされている最小のクライアント Windows 7 [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 R2 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー winbio.h