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