Fonction WinBioEnrollSelect (winbio.h)

Article
03/06/2024

Spécifie la personne que vous souhaitez inscrire lorsque des données représentant plusieurs personnes sont présentes dans l’exemple de mémoire tampon. À compter de Windows 10 build 1607, cette fonction peut être utilisée avec une image mobile.

Syntaxe

HRESULT WinBioEnrollSelect(
  [in] WINBIO_SESSION_HANDLE SessionHandle,
  [in] ULONGLONG             SelectorValue
);

Paramètres

[in] SessionHandle

Valeur WINBIO_SESSION_HANDLE qui identifie une session biométrique ouverte. Ouvrez un handle de session synchrone en appelant WinBioOpenSession. Ouvrez un handle de session asynchrone en appelant WinBioAsyncOpenSession.

Pour l’inscription à la reconnaissance faciale, utilisez WinBioAsyncOpenSession avec le paramètre PoolType défini sur WINBIO_POOL_SYSTEM pour obtenir le handle.

[in] SelectorValue

Valeur qui identifie la personne que vous souhaitez sélectionner pour l’inscription.

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_HANDLE	Le handle de session n’est pas valide.
E_INVALIDARG	Le paramètre SelectorValue ne peut pas être égal à zéro.
WINBIO_E_INCORRECT_SESSION_TYPE	Le handle de session ne correspond pas à une session biométrique.

Remarques

Pour l’inscription à la reconnaissance faciale, vous pouvez trouver la valeur de sélecteur appropriée de deux manières :

Valeur du membre ID de l’une des structures WINBIO_PRESENCE précédemment envoyées.
Données produites par les API de suivi des visages NUI.

Appelez WinBioEnrollSelect pour définir la valeur du sélecteur après avoir appelé WinBioEnrollBegin pour démarrer une séquence d’inscription. La valeur du sélecteur s’applique à tous les appels WinBioEnrollCapture suivants. Le paramètre de sélection est temporaire et est automatiquement effacé lorsque vous terminez la séquence d’inscription en appelant WinBioEnrollCommit ou WinBioEnrollDiscard.

Si vous appelez WinBioEnrollSelect pour des facteurs biométriques qui ne nécessitent pas d’ambiguïté, comme les empreintes digitales, la valeur de retour de la fonction indique la réussite, mais la fonction ignore la valeur du sélecteur.

Si vous n’appelez pas WinBioEnrollSelect pour un facteur biométrique qui vous oblige à appeler la fonction, les appels ultérieurs à WinBioEnrollCapture échouent avec l’erreur WINBIO_E_SELECTION_REQUIRED .

Par Windows 10, les facteurs qui vous obligent à appeler WinBioEnrollSelect sont les caractéristiques faciales et l’iris.

Vous pouvez appeler WinBioEnrollSelect à l’aide d’un handle de session synchrone ou asynchrone. Comme pour les autres appels aux fonctions de l’API Du Framework biométrique Windows, lorsque vous appelez WinBioEnrollSelect avec un handle de session asynchrone, la valeur de retour indique uniquement que les paramètres de la fonction étaient acceptables. La réussite ou l’échec réel de l’opération elle-même sera retournée à votre routine de notification dans une structure de WINBIO_ASYNC_RESULT .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 10 (applications de bureau uniquement)
Serveur minimal pris en charge	Windows Server 2016 (applications de bureau uniquement)
Plateforme cible	Windows
En-tête	winbio.h
Bibliothèque	Winbio.lib
DLL	Winbio.dll