Fonction WinBioOpenSession (winbio.h)

Article
08/27/2023

Se connecte à un fournisseur de services biométriques et à une ou plusieurs unités biométriques.

Syntaxe

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

Paramètres

[in] Factor

Masque de bits de WINBIO_BIOMETRIC_TYPE indicateurs qui spécifie les types d’unités biométriques à énumérer. Seule WINBIO_TYPE_FINGERPRINT est actuellement prise en charge.

[in] PoolType

Valeur ULONG qui spécifie le type des unités biométriques qui seront utilisées dans la session. Il peut s’agir de l’une des valeurs suivantes :

Valeur	Signification
WINBIO_POOL_SYSTEM	La session se connecte à une collection partagée d’unités biométriques gérées par le fournisseur de services.
WINBIO_POOL_PRIVATE	La session se connecte à une collection d’unités biométriques gérées par l’appelant.

[in] Flags

Valeur ULONG qui spécifie la configuration des unités biométriques et les caractéristiques d’accès pour la nouvelle session. Les indicateurs de configuration spécifient la configuration générale des unités dans la session. Les indicateurs d’accès spécifient la façon dont l’application utilisera les unités biométriques. Vous devez spécifier un indicateur de configuration, mais vous pouvez combiner cet indicateur avec n’importe quel indicateur d’accès.

Valeur	Signification
WINBIO_FLAG_DEFAULT	Groupe : configuration Les unités biométriques fonctionnent de la manière spécifiée lors de l’installation. Vous devez utiliser cette valeur lorsque le paramètre PoolType est WINBIO_POOL_SYSTEM.
WINBIO_FLAG_BASIC	Groupe : configuration Les unités biométriques fonctionnent uniquement comme des appareils de capture de base. Toutes les opérations de traitement, de correspondance et de stockage sont effectuées par des plug-ins logiciels.
WINBIO_FLAG_ADVANCED	Groupe : configuration Les unités biométriques utilisent des fonctionnalités de traitement et de stockage internes.
WINBIO_FLAG_RAW	Groupe : accès L’application cliente capture des données biométriques brutes à l’aide de WinBioCaptureSample.
WINBIO_FLAG_MAINTENANCE	Groupe : accès Le client effectue des opérations de contrôle définies par le fournisseur sur une unité biométrique en appelant WinBioControlUnitPrivileged.

[in] UnitArray

Pointeur vers un tableau d’identificateurs d’unités biométriques à inclure dans la session. Vous pouvez appeler WinBioEnumBiometricUnits pour énumérer les unités biométriques. Définissez cette valeur sur NULL si le paramètre PoolType est WINBIO_POOL_SYSTEM.

[in] UnitCount

Valeur qui spécifie le nombre d’éléments dans le tableau pointé vers le paramètre UnitArray . Définissez cette valeur sur zéro si le paramètre PoolType est WINBIO_POOL_SYSTEM.

[in] DatabaseId

Valeur qui spécifie la ou les bases de données à utiliser par la session. Si le paramètre PoolType est WINBIO_POOL_PRIVATE, vous devez spécifier le GUID d’une base de données installée. Si le paramètre PoolType n’est pas WINBIO_POOL_PRIVATE, vous pouvez spécifier l’une des valeurs courantes suivantes.

Valeur	Signification
WINBIO_DB_DEFAULT	Chaque unité biométrique du pool de capteurs utilise la base de données par défaut spécifiée dans la configuration d’unité biométrique par défaut. Vous devez spécifier cette valeur si le paramètre PoolType est WINBIO_POOL_SYSTEM. Vous ne pouvez pas utiliser cette valeur si le paramètre PoolType est WINBIO_POOL_PRIVATE
WINBIO_DB_BOOTSTRAP	Vous pouvez spécifier cette valeur à utiliser pour les scénarios avant le démarrage de Windows. En règle générale, la base de données fait partie de la puce du capteur ou fait partie du BIOS et ne peut être utilisée que pour l’inscription et la suppression de modèles.
WINBIO_DB_ONCHIP	La base de données se trouve sur la puce du capteur et est disponible pour l’inscription et la correspondance.

[out] SessionHandle

Pointeur vers le nouveau handle de session. Si la fonction échoue, le handle est défini sur zéro.

Valeur retournée

Si la fonction réussit, elle retourne S_OK. Si la fonction échoue, elle retourne une valeur HRESULT qui indique l’erreur. Les valeurs possibles sont notamment celles figurant dans le tableau suivant. Pour obtenir la liste des codes d’erreur courants, consultez Valeurs HRESULT courantes.

Code de retour	Description
E_INVALIDARG	Un ou plusieurs arguments ont des valeurs incorrectes ou sont incompatibles avec d’autres arguments.
E_POINTER	Le pointeur de handle de session dans le paramètre SessionHandle ne peut pas être NULL.
E_ACCESSDENIED	Le paramètre Flags contient le WINBIO_FLAG_RAW ou l’indicateur WINBIO_FLAG_MAINTENANCE et l’appelant n’a pas reçu l’autorisation d’accès.
WINBIO_E_INVALID_UNIT	Un ou plusieurs des numéros d’unité biométrique spécifiés dans le paramètre UnitArray ne sont pas valides.
WINBIO_E_NOT_ACTIVE_CONSOLE	L’application cliente s’exécute sur un client Bureau à distance et tente d’ouvrir une session de pool système.
WINBIO_E_SENSOR_UNAVAILABLE	Le paramètre PoolType est défini sur WINBIO_POOL_PRIVATE et un ou plusieurs des capteurs demandés dans ce pool ne sont pas disponibles.
WINBIO_E_DISABLED	La stratégie d’administration actuelle interdit l’utilisation de l’API Du framework biométrique Windows.

Configuration requise


Client minimal pris en charge	Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winbio.h (inclure Winbio.h)
Bibliothèque	Winbio.lib
DLL	Winbio.dll

Voir aussi

WinBioCloseSession

Partager via