Freigeben über

WinBioOpenSession-Funktion (winbio.h)

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

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

Die Parameter

[in] Factor

Eine Bitmaske von WINBIO_BIOMETRIC_TYPE Flags, die die biometrischen Einheitentypen angibt, die aufgezählt werden sollen. 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. Dies kann einer der folgenden Werte sein:

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

[in] Flags

Ein ULONG-Wert , der die Konfiguration und Zugriffsmerkmale der biometrischen Einheit für die neue Sitzung angibt. Konfigurationskennzeichnungen geben die allgemeine Konfiguration von Einheiten in der Sitzung an. Zugriffskennzeichnungen geben an, wie die Anwendung die biometrischen Einheiten verwendet. Sie müssen ein Konfigurationsflagge angeben, aber Sie können dieses Kennzeichen mit jeder Zugriffskennzeichnung 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 Aufnahmegerä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: Zugriff

Die Clientanwendung erfasst unformatierte biometrische Daten mit WinBioCaptureSample.
WINBIO_FLAG_MAINTENANCE
 Gruppe: Zugriff

Der Client führt herstellerdefinierte Kontrollvorgänge für eine biometrische Einheit durch Aufrufen von WinBioControlUnitPrivileged aus.

[in] UnitArray

Zeiger auf ein Array von biometrischen Einheitenbezeichnern, die in die Sitzung aufgenommen werden sollen. Sie können WinBioEnumBiometricUnits aufrufen, um die biometrischen Einheiten aufzählen zu können. 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 die der UnitArray-Parameter verweist. Legen Sie diesen Wert auf Null fest, wenn der Parameter "PoolType " WINBIO_POOL_SYSTEM ist.

[in] DatabaseId

Ein Wert, der die datenbank(n) angibt, die von der Sitzung verwendet werden soll. Wenn der Parameter "PoolType " WINBIO_POOL_PRIVATE ist, müssen Sie die GUID einer installierten Datenbank angeben. Wenn der Parameter "PoolType " 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 Standardkonfiguration für biometrische Einheiten angegeben ist. Sie müssen diesen Wert angeben, wenn der Parameter PoolTypeWINBIO_POOL_SYSTEM ist. Sie können diesen Wert nicht verwenden, wenn der Parameter "PoolType " WINBIO_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 für die Vorlagenregistrierung und -löschung verwendet werden.
WINBIO_DB_ONCHIP
 Die Datenbank befindet sich auf dem Sensorchip und ist für die Registrierung und den Abgleich verfügbar.

[out] SessionHandle

Zeiger auf das neue Sitzungshandle. Wenn die Funktion nicht erfolgreich ist, wird der Handle auf 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ögliche Werte sind die Werte in der folgenden Tabelle, sind jedoch nicht beschränkt. Eine Liste allgemeiner Fehlercodes finden Sie unter "Allgemeine HRESULT-Werte".

Rückgabecode Description
E_INVALIDARG
 Mindestens ein Argument hat falsche Werte oder sind mit anderen Argumenten nicht kompatibel.
E_POINTER
 Der Zeiger des Sitzungshandle-Zeigers im Parameter SessionHandle darf nicht NULL sein.
E_ACCESSDENIED
 Der Parameter "Flags" enthält die WINBIO_FLAG_RAW oder das WINBIO_FLAG_MAINTENANCE Flag, und der Aufrufer wurde keiner der Zugriffsberechtigungen erteilt.
WINBIO_E_INVALID_UNIT
 Mindestens eine der im Parameter UnitArray 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 Parameter PoolType ist auf WINBIO_POOL_PRIVATE festgelegt, und mindestens eine der angeforderten Sensoren in diesem Pool ist nicht verfügbar.
WINBIO_E_DISABLED
 Die aktuelle Administrative Richtlinie verbietet die Verwendung der Windows-Biometrie-Framework-API.

Anforderungen

Anforderung Wert
Mindestens unterstützter Client Windows 7 [nur Desktop-Apps]
Mindestanforderungen für unterstützte Server Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform Fenster
Header winbio.h (enthalten Winbio.h)
Library Winbio.lib
DLL Winbio.dll

Siehe auch

WinBioCloseSession

  • Last updated on