共用方式為

WinBioAsyncEnumBiometricUnits 函式 (winbio.h)

  • 發行項

以非同步方式列舉符合輸入因數類型的所有附加生物特徵辨識單位。 如需此函式的同步版本，請參閱 WinBioEnumBiometricUnits。 從 Windows 10 組建 1607 開始，此函式可用來搭配行動映射使用。

語法

HRESULT WinBioAsyncEnumBiometricUnits(
  [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參數中包含的位元遮罩包含一或多個不正確類型位。
E_OUTOFMEMORY
 記憶體不足，無法完成要求。
WINBIO_E_DISABLED
 目前的系統管理原則禁止使用 Windows 生物特徵辨識架構 API。
WINBIO_E_INCORRECT_SESSION_TYPE
 FrameworkHandle引數必須代表非同步架構會話。
WINBIO_E_SESSION_HANDLE_CLOSED
 會話控制碼已標示為關閉。

備註

WinBioAsyncEnumBiometricUnits函式會使用呼叫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結構內的EnumBiometricUnits結構中。 使用完之後，您必須呼叫 WinBioFree 來釋放 WINBIO_ASYNC_RESULT 結構。

呼叫 WinBioAsyncEnumBiometricUnits 會導致將單一通知傳送至用戶端應用程式。

規格需求

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

另請參閱

WinBioAsyncOpenFramework