WinBioAsyncMonitorFrameworkChanges, fonction (winbio.h)

Démarre une analyse asynchrone des modifications apportées à l’infrastructure biométrique. Actuellement, les seules modifications surveillées prises en charge se produisent lorsqu’une unité biométrique est attachée ou détachée de l’ordinateur.

Syntaxe

HRESULT WinBioAsyncMonitorFrameworkChanges(
  [in] WINBIO_FRAMEWORK_HANDLE      FrameworkHandle,
  [in] WINBIO_FRAMEWORK_CHANGE_TYPE ChangeTypes
);

Paramètres

[in] FrameworkHandle

Gérez la session d’infrastructure ouverte en appelant WinBioAsyncOpenFramework.

[in] ChangeTypes

Masque de bits de type WINBIO_FRAMEWORK_CHANGE_TYPE indicateurs qui indique les types d’événements qui doivent générer des notifications asynchrones. À compter de Windows 8, l’indicateur suivant est disponible :

Valeur	Signification
WINBIO_FRAMEWORK_CHANGE_UNIT	Une unité biométrique a été attachée ou détachée de l’ordinateur.

Valeur retournée

La fonction retourne un HRESULT indiquant la réussite ou l’échec. Notez que la réussite indique uniquement que les arguments de fonction étaient valides. Les échecs rencontrés pendant l’exécution de l’opération sont retournés de manière asynchrone à une structure WINBIO_ASYNC_RESULT à l’aide de la méthode de notification spécifiée dans WinBioAsyncOpenFramework.

Code de retour	Description
E_HANDLE	Vous devez définir l’argument FrameworkHandle .
E_INVALIDARG	Le masque de bits contenu dans le paramètre ChangeTypes contient un ou plusieurs bits de type non valides. Actuellement, la seule valeur disponible est WINBIO_FRAMEWORK_CHANGE_UNIT.
WINBIO_E_INCORRECT_SESSION_TYPE	L’argument FrameworkHandle doit représenter une session d’infrastructure asynchrone.

Remarques

Une fois démarré, ce moniteur continue à générer des événements jusqu’à ce que l’application cliente appelle WinBioCancel ou WinBioCloseFramework. La création d’un moniteur pour les événements WINBIO_FRAMEWORK_CHANGE_UNIT génère deux types de notifications asynchrones :

Valeur	Signification
WINBIO_OPERATION_UNIT_ARRIVAL	Une unité biométrique est attachée.
WINBIO_OPERATION_UNIT_REMOVAL	Une unité biométrique est détachée.

 

La fonction WinBioAsyncMonitorFrameworkChanges utilise un handle pour la session d’infrastructure ouverte en appelant WinBioAsyncOpenFramework. L’infrastructure alloue une structure WINBIO_ASYNC_RESULT et l’utilise pour retourner des informations sur la réussite ou l’échec de l’opération. Si une unité biométrique est attachée ou détachée de l’ordinateur, l’infrastructure définit le membre Operation de la structure. Si un problème est rencontré pendant l’opération, l’infrastructure utilise la structure WINBIO_ASYNC_RESULT pour retourner des informations d’erreur. La structure est retournée au rappel d’application ou à la file d’attente des messages de l’application, en fonction de la valeur que vous avez définie dans le paramètre NotificationMethod de la fonction WinBioAsyncOpenFramework .

• Si vous choisissez de recevoir des notifications d’achèvement à l’aide d’un rappel, vous devez implémenter une fonction PWINBIO_ASYNC_COMPLETION_CALLBACK et définir le paramètre NotificationMethod sur WINBIO_ASYNC_NOTIFY_CALLBACK.
• Si vous choisissez de recevoir des notifications d’achèvement à l’aide de la file d’attente de messages d’application, vous devez définir le paramètre NotificationMethodsur WINBIO_ASYNC_NOTIFY_MESSAGE. L’infrastructure retourne un pointeur WINBIO_ASYNC_RESULT vers le champ LPARAM du message de fenêtre.

Les notifications sont retournées dans une structure EnumServiceProviders imbriquée dans la structure WINBIO_ASYNC_RESULT . Vous devez appeler WinBioFree pour libérer la structure WINBIO_ASYNC_RESULT une fois que vous avez terminé de l’utiliser.

Configuration requise

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

Voir aussi

WinBioAsyncOpenFramework