Fonction WinBioMonitorPresence (winbio.h)
Active le mécanisme de reconnaissance faciale ou de surveillance de l’iris pour l’unité biométrique spécifiée. À compter de Windows 10 build 1607, cette fonction peut être utilisée avec une image mobile.
Syntaxe
HRESULT WinBioMonitorPresence(
[in] WINBIO_SESSION_HANDLE SessionHandle,
[in] WINBIO_UNIT_ID UnitId
);
Paramètres
[in] SessionHandle
Handle asynchrone pour la session biométrique que vous avez obtenue en appelant la fonction WinBioAsyncOpenSession avec le paramètre PoolType défini sur WINBIO_POOL_SYSTEM.
[in] UnitId
Identificateur de l’unité biométrique pour laquelle vous souhaitez activer le mécanisme de reconnaissance faciale ou de surveillance de l’iris.
Valeur retournée
Si les paramètres de fonction sont acceptables, elle retourne S_OK. Si les paramètres de fonction ne sont pas acceptables, 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 |
|---|---|
|
Le handle de session n’est pas valide. |
|
Le paramètre UnitId ne peut pas être égal à zéro. |
|
Le handle de session ne correspond pas à une session biométrique asynchrone. |
La réussite ou l’échec réel de l’opération elle-même est retournée à votre fonction de notification dans une structure de WINBIO_ASYNC_RESULT .
Remarques
Une session biométrique unique ne peut avoir qu’un seul moniteur de présence actif à tout moment.
Une fois que vous avez correctement appelé WinBioMonitorPresence, votre fonction de notification reçoit des notifications sous la forme d’une structure de WINBIO_ASYNC_RESULT avec un membre Operation égal à WINBIO_OPERATION_MONITOR_PRESENCE. Vous devez ensuite examiner le membre Parameters.MonitorPresence de la structure WINBIO_ASYNC_RESULT pour plus d’informations.
Pour arrêter de recevoir des notifications, appelez WinBioCancel ou WinBioCloseSession avec la valeur de handle asynchrone d’origine.
Configuration requise
| 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 |