共用方式為

WinBioOpenSession 函式（winbio.h）

連接生物辨識服務提供者及一個或多個生物辨識單位。

語法

HRESULT WinBioOpenSession(
  [in]  WINBIO_BIOMETRIC_TYPE Factor,
  [in]  WINBIO_POOL_TYPE      PoolType,
  [in]  WINBIO_SESSION_FLAGS  Flags,
  [in]  WINBIO_UNIT_ID        *UnitArray,
  [in]  SIZE_T                UnitCount,
  [in]  GUID                  *DatabaseId,
  [out] WINBIO_SESSION_HANDLE *SessionHandle
);

參數

[in] Factor

一個由 WINBIO_BIOMETRIC_TYPE 旗標組成的位元遮罩，指定要列舉的生物特徵單位類型。 目前只支援 WINBIO_TYPE_FINGERPRINT 。

[in] PoolType

一個 ULONG 值，指定該會話中將使用的生物特徵單位類型。 這可以是下列其中一個值：

價值觀 Meaning
WINBIO_POOL_SYSTEM
 該會話連接至由服務提供者管理的共享生物特徵單元集合。
WINBIO_POOL_PRIVATE
 該會話連接由呼叫者管理的一組生物特徵單元。

[in] Flags

ULONG 值，指定新會話的生物特徵單元配置與存取特性。 配置旗標指定會話中單元的一般配置。 存取標誌則指定應用程式如何使用生物特徵單元。 你必須指定一個設定標誌，但你可以將該標誌與任何存取標誌合併使用。

價值觀 Meaning
WINBIO_FLAG_DEFAULT
 群組：配置

生物辨識單元的運作方式依安裝時指定方式運作。 當 PoolType 參數WINBIO_POOL_SYSTEM時，必須使用此值。
WINBIO_FLAG_BASIC
 群組：配置

生物辨識單元僅作為基本的擷取裝置運作。 所有處理、匹配與儲存操作皆由軟體外掛程式執行。
WINBIO_FLAG_ADVANCED
 群組：配置

生物辨識單元採用內部處理與儲存功能。
WINBIO_FLAG_RAW
 群組：通行

用戶端應用程式使用 WinBioCaptureSample 擷取原始生物特徵資料。
WINBIO_FLAG_MAINTENANCE
 群組：通行

用戶端透過呼叫 WinBioControlUnitPrivileged 來對生物辨識單元執行廠商定義的控制操作。

[in] UnitArray

指標指向一組生物特徵單元識別碼陣列，將納入會話中。 你可以呼叫 WinBioEnumBiometricUnits 來列舉生物特徵單位。 如果 PoolType 參數為 WINBIO_POOL_SYSTEM，則將此值設為 NULL。

[in] UnitCount

一個指定 UnitArray 參數指向陣列中元素數量的值。 如果 PoolType 參數為 WINBIO_POOL_SYSTEM，則將此值設為零。

[in] DatabaseId

一個指定會話要使用的資料庫的值。 如果 PoolType 參數是 WINBIO_POOL_PRIVATE，你必須指定已安裝資料庫的 GUID。 如果 PoolType 參數未 WINBIO_POOL_PRIVATE，你可以指定以下常見值之一。

價值觀 Meaning
WINBIO_DB_DEFAULT
 感測器池中的每個生物特徵單元使用預設生物特徵單元設定中指定的資料庫。 如果 PoolType 參數為 WINBIO_POOL_SYSTEM，必須指定此值。 如果 PoolType 參數是 WINBIO_POOL_PRIVATE，你就不能使用這個值
WINBIO_DB_BOOTSTRAP
 你可以指定這個值用於啟動 Windows 前的情境。 通常，資料庫是感測器晶片或 BIOS 的一部分，只能用於範本的註冊與刪除。
WINBIO_DB_ONCHIP
 資料庫安裝在感測器晶片上，供登錄與配對。

[out] SessionHandle

指標指向新的 session handle。 若函式未成功，則將 handle 設為零。

返回值

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

回傳碼 Description
E_INVALIDARG
 一個或多個參數的值不正確，或與其他參數不相容。
E_POINTER
 SessionHandle 參數中的會話句柄指標不能是 NULL。
E_ACCESSDENIED
 Flags 參數包含 WINBIO_FLAG_RAW 或 WINBIO_FLAG_MAINTENANCE 標誌，呼叫者尚未獲得任一存取權限。
WINBIO_E_INVALID_UNIT
 UnitArray 參數中指定的一個或多個生物特徵單位號碼不適用。
WINBIO_E_NOT_ACTIVE_CONSOLE
 用戶端應用程式正在遠端桌面用戶端執行，並嘗試開啟系統池會話。
WINBIO_E_SENSOR_UNAVAILABLE
 PoolType 參數設為 WINBIO_POOL_PRIVATE，且該池中一個或多個請求的感測器無法使用。
WINBIO_E_DISABLED
 現行管理政策禁止使用 Windows 生物特徵框架 API。

需求

Requirement 價值觀
最低支援的用戶端 Windows 7 [僅限桌面應用程式]
支援的最低伺服器 Windows Server 2008 R2 [僅限傳統型應用程式]
目標平臺 窗戶
Header winbio.h（包括Winbio.h）
Library Winbio.lib 網站
DLL Winbio.dll

另請參閱

WinBioCloseSession

  • Last updated on