次の方法で共有

WinBioAsyncEnumDatabases 関数 (winbio.h)

  • [アーティクル]

指定した型に一致するすべての登録済みデータベースを非同期的に列挙します。 この関数の同期バージョンについては、「 WinBioEnumDatabases」を参照してください。

構文

HRESULT WinBioAsyncEnumDatabases(
  [in] WINBIO_FRAMEWORK_HANDLE FrameworkHandle,
  [in] WINBIO_BIOMETRIC_TYPE   Factor
);

パラメーター

[in] FrameworkHandle

WinBioAsyncOpenFramework を呼び出して開いたフレームワーク セッションを処理します。

[in] Factor

列挙する生体認証データベースの種類を指定する WINBIO_BIOMETRIC_TYPE フラグのビットマスク。 現在 、WINBIO_TYPE_FINGERPRINT のみがサポートされています。

戻り値

関数は、成功または失敗を示す HRESULT を返します。 成功は、関数の引数が有効であることを示すだけであることに注意してください。 操作の実行中に発生したエラーは、WinBioAsyncOpenFramework の呼び出しで指定された通知メソッドを使用して、WINBIO_ASYNC_RESULT構造体に非同期的に返されます。

リターン コード 説明
E_HANDLE
 FrameworkHandle 引数を設定する必要があります。
E_INVALIDARG
 Factor パラメーターに含まれるビットマスクには、無効な型ビットが 1 つ以上含まれています。
E_OUTOFMEMORY
 要求を完了するためのメモリが不足していました。
WINBIO_E_INCORRECT_SESSION_TYPE
 FrameworkHandle 引数は、非同期フレームワーク セッションを表す必要があります。

注釈

WinBioAsyncEnumDatabases 関数は、WinBioAsyncOpenFramework を呼び出して開いたフレームワーク セッションへのハンドルを使用します。 フレームワークは 、WINBIO_ASYNC_RESULT 構造体を割り当て、それを使用して操作の成功または失敗に関する情報を返します。 列挙操作が成功した場合、フレームワークは、列挙された各データベースに関する情報を含むスキーマの配列を返します。 操作が失敗した場合、フレームワークは WINBIO_ASYNC_RESULT 構造体を使用してエラー情報を返します。 構造体は、WinBioAsyncOpenFramework 関数の NotificationMethod パラメーターで設定した値に応じて、アプリケーション コールバックまたはアプリケーション メッセージ キューに返されます。

  • コールバックを使用して完了通知を受け取る場合は、 PWINBIO_ASYNC_COMPLETION_CALLBACK 関数を実装し、 NotificationMethod パラメーターを WINBIO_ASYNC_NOTIFY_CALLBACK に設定する必要があります。
  • アプリケーション メッセージ キューを使用して完了通知を受け取る場合は、 NotificationMethod パラメーターを WINBIO_ASYNC_NOTIFY_MESSAGE に設定する必要があります。 フレームワークは、ウィンドウ メッセージの LPARAM フィールドへのWINBIO_ASYNC_RESULT ポインターを返します。
スキーマの配列は、WINBIO_ASYNC_RESULT構造体内に入れ子になった EnumDatabases 構造体で返されます。 WinBioFree を呼び出して、WINBIO_ASYNC_RESULT構造体の使用が完了したら解放する必要があります。

WinBioAsyncEnumDatabases を呼び出すと、1 つの通知がクライアント アプリケーションに送信されます。

要件

要件 値
サポートされている最小のクライアント Windows 8 [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2012 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー winbio.h (Winbio.h を含む)
Library Winbio.lib
[DLL] Winbio.dll

こちらもご覧ください

WinBioAsyncOpenFramework