WinBioOpenSession-Funktion (winbio.h)

Artikel
08/27/2023

Stellt eine Verbindung mit einem Biometrischen Dienstanbieter und einer oder mehreren biometrischen Einheiten her.

Syntax

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
);

Parameter

[in] Factor

Eine Bitmaske mit WINBIO_BIOMETRIC_TYPE Flags, die die zu enumerierten biometrischen Einheitentypen angibt. Derzeit wird nur WINBIO_TYPE_FINGERPRINT unterstützt.

[in] PoolType

Ein ULONG-Wert , der den Typ der biometrischen Einheiten angibt, die in der Sitzung verwendet werden. Mögliche Werte:

Wert	Bedeutung
WINBIO_POOL_SYSTEM	Die Sitzung stellt eine Verbindung mit einer freigegebenen Sammlung biometrischer Einheiten her, die vom Dienstanbieter verwaltet werden.
WINBIO_POOL_PRIVATE	Die Sitzung stellt eine Verbindung mit einer Sammlung biometrischer Einheiten her, die vom Aufrufer verwaltet werden.

[in] Flags

Ein ULONG-Wert , der die Konfiguration der biometrischen Einheit und die Zugriffsmerkmale für die neue Sitzung angibt. Konfigurationsflags geben die allgemeine Konfiguration von Einheiten in der Sitzung an. Zugriffsflags geben an, wie die Anwendung die biometrischen Einheiten verwendet. Sie müssen ein Konfigurationsflag angeben, aber Sie können dieses Flag mit einem beliebigen Zugriffsflag kombinieren.

Wert	Bedeutung
WINBIO_FLAG_DEFAULT	Gruppe: Konfiguration Die biometrischen Einheiten funktionieren in der während der Installation angegebenen Weise. Sie müssen diesen Wert verwenden, wenn der PoolType-Parameter WINBIO_POOL_SYSTEM ist.
WINBIO_FLAG_BASIC	Gruppe: Konfiguration Die biometrischen Einheiten funktionieren nur als einfache Erfassungsgeräte. Alle Verarbeitungs-, Abgleichs- und Speichervorgänge werden von Software-Plug-Ins ausgeführt.
WINBIO_FLAG_ADVANCED	Gruppe: Konfiguration Die biometrischen Einheiten verwenden interne Verarbeitungs- und Speicherfunktionen.
WINBIO_FLAG_RAW	Gruppe: Access Die Clientanwendung erfasst biometrische Rohdaten mithilfe von WinBioCaptureSample.
WINBIO_FLAG_MAINTENANCE	Gruppe: Access Der Client führt vom Hersteller definierte Kontrollvorgänge für eine biometrische Einheit durch, indem WinBioControlUnitPrivileged aufgerufen wird.

[in] UnitArray

Zeiger auf ein Array von biometrischen Einheitenbezeichnern, die in die Sitzung eingeschlossen werden sollen. Sie können WinBioEnumBiometricUnits aufrufen, um die biometrischen Einheiten aufzulisten. Legen Sie diesen Wert auf NULL fest, wenn der PoolType-ParameterWINBIO_POOL_SYSTEM ist.

[in] UnitCount

Ein -Wert, der die Anzahl der Elemente im Array angibt, auf das der UnitArray-Parameter verweist. Legen Sie diesen Wert auf 0 fest, wenn der Parameter PoolTypeWINBIO_POOL_SYSTEM ist.

[in] DatabaseId

Ein -Wert, der die von der Sitzung zu verwendenden Datenbanken angibt. Wenn der PoolType-ParameterWINBIO_POOL_PRIVATE ist, müssen Sie die GUID einer installierten Datenbank angeben. Wenn der PoolType-Parameter nicht WINBIO_POOL_PRIVATE ist, können Sie einen der folgenden allgemeinen Werte angeben.

Wert	Bedeutung
WINBIO_DB_DEFAULT	Jede biometrische Einheit im Sensorpool verwendet die Standarddatenbank, die in der Konfiguration der biometrischen Standardeinheit angegeben ist. Sie müssen diesen Wert angeben, wenn der Parameter PoolTypeWINBIO_POOL_SYSTEM ist. Sie können diesen Wert nicht verwenden, wenn der PoolType-ParameterWINBIO_POOL_PRIVATE
WINBIO_DB_BOOTSTRAP	Sie können diesen Wert angeben, der für Szenarien vor dem Starten von Windows verwendet werden soll. In der Regel ist die Datenbank Teil des Sensorchips oder Teil des BIOS und kann nur zum Registrieren und Löschen von Vorlagen verwendet werden.
WINBIO_DB_ONCHIP	Die Datenbank befindet sich auf dem Sensorchip und steht für die Registrierung und den Abgleich zur Verfügung.

[out] SessionHandle

Zeiger auf das neue Sitzungshandle. Wenn die Funktion nicht erfolgreich ist, wird das Handle auf 0 (null) festgelegt.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird S_OK zurückgegeben. Wenn die Funktion fehlschlägt, wird ein HRESULT-Wert zurückgegeben, der den Fehler angibt. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle. Eine Liste allgemeiner Fehlercodes finden Sie unter Allgemeine HRESULT-Werte.

Rückgabecode	Beschreibung
E_INVALIDARG	Mindestens ein Argument hat falsche Werte oder ist mit anderen Argumenten nicht kompatibel.
E_POINTER	Der Sitzungshandlezeiger im Parameter SessionHandle darf nicht NULL sein.
E_ACCESSDENIED	Der Flags-Parameter enthält das WINBIO_FLAG_RAW - oder das WINBIO_FLAG_MAINTENANCE-Flag , und dem Aufrufer wurde keine Zugriffsberechtigung erteilt.
WINBIO_E_INVALID_UNIT	Mindestens eine der im UnitArray-Parameter angegebenen biometrischen Einheitennummern ist ungültig.
WINBIO_E_NOT_ACTIVE_CONSOLE	Die Clientanwendung wird auf einem Remotedesktopclient ausgeführt und versucht, eine Systempoolsitzung zu öffnen.
WINBIO_E_SENSOR_UNAVAILABLE	Der PoolType-Parameter ist auf WINBIO_POOL_PRIVATE festgelegt, und mindestens einer der angeforderten Sensoren in diesem Pool ist nicht verfügbar.
WINBIO_E_DISABLED	Die aktuelle Verwaltungsrichtlinie verbietet die Verwendung der Windows Biometric Framework-API.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winbio.h (winbio.h einschließen)
Bibliothek	Winbio.lib
DLL	Winbio.dll

Weitere Informationen

WinBioCloseSession

Share via