Fonction WinBioMonitorPresence (winbio.h)

Article
08/27/2023

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
E_HANDLE	Le handle de session n’est pas valide.
E_INVALIDARG	Le paramètre UnitId ne peut pas être égal à zéro.
WINBIO_E_INCORRECT_SESSION_TYPE	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

Voir aussi

WINBIO_ASYNC_RESULT

WinBioAsyncOpenSession

WinBioCancel

WinBioCloseSession

Partager via