共用方式為

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值，指定將在會話中使用的生物特徵辨識單位類型。 這個值可以是下列其中一個值：

值 意義
WINBIO_POOL_SYSTEM
 會話會連線到服務提供者所管理生物特徵辨識單位的共用集合。
WINBIO_POOL_PRI加值稅E
 會話會連線到呼叫端所管理生物特徵辨識單位的集合。

[in] Flags

ULONG值，指定新會話的生物特徵辨識單位組態和存取特性。 組態旗標會指定會話中單位的一般設定。 存取旗標會指定應用程式如何使用生物特徵辨識單位。 您必須指定一個組態旗標，但您可以將該旗標與任何存取旗標結合。

值 意義
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_PRI加值稅E，您必須指定已安裝資料庫的 GUID。 如果 PoolType 參數未 WINBIO_POOL_PRI加值稅E，您可以指定下列其中一個通用值。

值 意義
WINBIO_DB_DEFAULT
 感應器集區中的每個生物特徵辨識單位都會使用預設生物特徵辨識單位設定中指定的預設資料庫。 如果 PoolType 參數 WINBIO_POOL_SYSTEM，您必須指定此值。 如果PoolType參數WINBIO_POOL_PRI加值稅E，則無法使用此值
WINBIO_DB_BOOTSTRAP
 您可以在啟動 Windows 之前，指定要用於案例的這個值。 一般而言，資料庫是感應器晶片的一部分，或是 BIOS 的一部分，而且只能用於範本註冊和刪除。
WINBIO_DB_ONCHIP
 資料庫位於感應器晶片上，可供註冊和比對。

[out] SessionHandle

新會話控制碼的指標。 如果函式不成功，控制碼會設定為零。

傳回值

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

傳回碼 描述
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_PRI加值稅E，而且該集區中的一或多個要求的感應器無法使用。
WINBIO_E_DISABLED
 目前的系統管理原則禁止使用 Windows 生物特徵辨識架構 API。

規格需求

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

另請參閱

WinBioCloseSession