共用方式為

WinBioAsyncMonitorFrameworkChanges 函式 (winbio.h)

  • 發行項

啟動生物特徵辨識架構變更的異步監視。 目前，唯一支援的受監視變更會在生物特徵辨識單元附加至計算機或從計算機中斷連結時發生。

語法

HRESULT WinBioAsyncMonitorFrameworkChanges(
  [in] WINBIO_FRAMEWORK_HANDLE      FrameworkHandle,
  [in] WINBIO_FRAMEWORK_CHANGE_TYPE ChangeTypes
);

參數

[in] FrameworkHandle

呼叫 WinBioAsyncOpenFramework 開啟的架構會話句柄。

[in] ChangeTypes

類型 為 WINBIO_FRAMEWORK_CHANGE_TYPE 旗標的位掩碼，指出應該產生異步通知的事件類型。 從 Windows 8 開始，可以使用下列旗標：

值 意義
WINBIO_FRAMEWORK_CHANGE_UNIT
 生物特徵辨識單元已連結至計算機或從計算機中斷連結。

傳回值

函式會傳回 HRESULT ，指出成功或失敗。 請注意，成功表示函式自變數有效。 在作業執行期間發生的失敗，將會使用 WinBioAsyncOpenFramework 中指定的通知方法，以異步方式傳回至WINBIO_ASYNC_RESULT結構。

傳回碼 Description
E_HANDLE
 您必須設定 FrameworkHandle 自變數。
E_INVALIDARG
 ChangeTypes 參數中包含的位掩碼包含一或多個無效的類型位。 目前唯一可用的值為 WINBIO_FRAMEWORK_CHANGE_UNIT。
WINBIO_E_INCORRECT_SESSION_TYPE
 FrameworkHandle 自變數必須代表異步架構會話。

備註

啟動之後，此監視器會繼續產生事件，直到用戶端應用程式呼叫 WinBioCancel 或 WinBioCloseFramework 為止。 建立 WINBIO_FRAMEWORK_CHANGE_UNIT 事件的監視會產生兩種類型的異步通知：

值 意義
WINBIO_OPERATION_UNIT_ARRIVAL 已附加生物特徵辨識單位。
WINBIO_OPERATION_UNIT_REMOVAL 生物特徵辨識單位已中斷連結。
 

WinBioAsyncMonitorFrameworkChanges 函式會使用呼叫 WinBioAsyncOpenFramework 所開啟之架構會話的句柄。 架構會配置 WINBIO_ASYNC_RESULT 結構，並用它來傳回作業成功或失敗的相關信息。 如果生物特徵辨識單元與計算機連結或中斷連結，架構會設定 結構的 Operation 成員。 如果在作業期間遇到問題，架構會使用 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結構內的 EnumServiceProviders 結構中傳回。 使用完之後，您必須呼叫 WinBioFree 來釋放 WINBIO_ASYNC_RESULT 結構。

規格需求

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

另請參閱

WinBioAsyncOpenFramework