winBioMonitorPresence 函式 (winbio.h)
開啟指定生物特徵辨識單位的臉部辨識或鳶尾花監視機制。 從 Windows 10 組建 1607 開始,此函式可用來搭配行動映射使用。
語法
HRESULT WinBioMonitorPresence(
[in] WINBIO_SESSION_HANDLE SessionHandle,
[in] WINBIO_UNIT_ID UnitId
);
參數
[in] SessionHandle
呼叫 WinBioAsyncOpenSession 函式,並將 PoolType 參數設定為 WINBIO_POOL_SYSTEM,以取得生物特徵辨識會話的非同步控制碼。
[in] UnitId
您要開啟臉部辨識或鳶尾花監視機制之生物特徵辨識單位的識別碼。
傳回值
如果函式參數是可接受的,它會傳回 S_OK。 如果無法接受函式參數,則會傳回指出錯誤的 HRESULT 值。
可能的值包括 (但不限於) 下表中的這些值。 如需常見錯誤碼的清單,請參閱 一般 HRESULT 值。
傳回碼 | 描述 |
---|---|
|
會話控制碼無效。 |
|
UnitId參數不可以等於零。 |
|
會話控制碼未對應至非同步生物特徵辨識會話。 |
作業本身的實際成功或失敗會傳回至 WINBIO_ASYNC_RESULT 結構中的通知函式。
備註
單一生物特徵辨識會話在任何時間點只能有一個作用中的目前狀態監視器。
成功呼叫 WinBioMonitorPresence之後,您的通知函式會以 WINBIO_ASYNC_RESULT結構的形式 接收通知,而 Operation 成員等於 WINBIO_OPERATION_MONITOR_PRESENCE。 然後,您應該檢查WINBIO_ASYNC_RESULT結構的Parameters.MonitorPresence成員,以取得詳細資訊。
若要停止接收通知,請使用原始非同步控制碼值呼叫 WinBioCancel 或 WinBioCloseSession 。
規格需求
最低支援的用戶端 | Windows 10 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2016 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | winbio.h |
程式庫 | Winbio.lib |
Dll | Winbio.dll |