共用方式為

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結構。

傳回碼 Description
E_HANDLE
 您必須設定 FrameworkHandle 自變數。
E_INVALIDARG
 Factor 參數中包含的位掩碼包含一或多個無效的類型位。
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 會導致將單一通知傳送至客戶端應用程式。

規格需求

需求 值
最低支援的用戶端 Windows 8 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2012 [僅限傳統型應用程式]
目標平台 Windows
標頭 winbio.h (包含Winbio.h)
程式庫 Winbio.lib
Dll Winbio.dll

另請參閱

WinBioAsyncOpenFramework