winBioEnrollSelect 函式 (winbio.h)

發行項
03/13/2024

指定當代表多個個人的數據出現在範例緩衝區中時，您想要註冊的個別。從 Windows 10 組建 1607 開始，此函式可用來搭配行動映射使用。

語法

HRESULT WinBioEnrollSelect(
  [in] WINBIO_SESSION_HANDLE SessionHandle,
  [in] ULONGLONG             SelectorValue
);

參數

[in] SessionHandle

識別開放式生物特徵辨識會話 的WINBIO_SESSION_HANDLE 值。呼叫 WinBioOpenSession 以開啟同步會話句柄。呼叫 WinBioAsyncOpenSession 來開啟異步會話句柄。

若要在臉部辨識中註冊，請使用 WinBioAsyncOpenSession 並將 PoolType 參數設定為 WINBIO_POOL_SYSTEM 以取得句柄。

[in] SelectorValue

值，識別您要選取要註冊的個人。

傳回值

如果函式成功，則會傳回S_OK。如果函式失敗，它會傳回 指出錯誤的 HRESULT 值。可能的值包括 (但不限於) 下表中的這些值。如需常見錯誤碼的清單，請參閱一般 HRESULT 值。

傳回碼	Description
E_HANDLE	會話句柄無效。
E_INVALIDARG	SelectorValue 參數不可以等於零。
WINBIO_E_INCORRECT_SESSION_TYPE	會話句柄未對應至生物特徵辨識會話。

備註

針對臉部辨識的註冊，您可以使用下列兩種方式之一找到正確的選取器值：

先前所傳送WINBIO_PRESENCE結構之一的Id成員值。
NUI 臉部追蹤 API 所產生的數據。

呼叫 WinBioEnrollSelect 以在呼叫 WinBioEnrollBegin 以啟動註冊順序之後設定選取器值。選取器值適用於所有後續的 WinBioEnrollCapture 呼叫。選取設定是暫時性的，當您呼叫 WinBioEnrollCommit 或 WinBioEnrollDiscard 完成註冊順序時，會自動清除。

如果您呼叫 WinBioEnrollSelect 表示不需要混淆生物特徵辨識因素，例如指紋，函式的傳回值會指出成功，但函式會忽略選取器值。

如果您未針對需要呼叫函式的生物特徵辨識因數呼叫 WinBioEnrollSelect ，後續對 WinBioEnrollCapture 的呼叫會失敗，並出現 WINBIO_E_SELECTION_REQUIRED 錯誤。

對於 Windows 10，您需要呼叫 WinBioEnrollSelect 的因素是臉部特徵和鳶尾花。

您可以使用同步或異步會話句柄來呼叫 WinBioEnrollSelect 。如同對 Windows 生物特徵辨識架構 API 函式的其他呼叫，當您使用異步會話句柄呼叫 WinBioEnrollSelect 時，傳回值只會指出函式參數是可接受的。作業本身的實際成功或失敗將會以 WINBIO_ASYNC_RESULT 結構傳回通知例程。

規格需求

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