Partager via

Fonction WinBioAsyncEnumDatabases (winbio.h)

  • Article

Énumère de façon asynchrone toutes les bases de données inscrites qui correspondent à un type spécifié. Pour obtenir une version synchrone de cette fonction, consultez WinBioEnumDatabases.

Syntaxe

HRESULT WinBioAsyncEnumDatabases(
  [in] WINBIO_FRAMEWORK_HANDLE FrameworkHandle,
  [in] WINBIO_BIOMETRIC_TYPE   Factor
);

Paramètres

[in] FrameworkHandle

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

[in] Factor

Masque de bits de WINBIO_BIOMETRIC_TYPE indicateurs qui spécifie les types de bases de données biométriques à énumérer. Seule WINBIO_TYPE_FINGERPRINT est actuellement prise en charge.

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 la fonction étaient valides. Les échecs rencontrés lors de 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 l’appel à 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 Factor contient un ou plusieurs bits de type non valide.
E_OUTOFMEMORY
 La mémoire était insuffisante pour terminer la demande.
WINBIO_E_INCORRECT_SESSION_TYPE
 L’argument FrameworkHandle doit représenter une session d’infrastructure asynchrone.

Remarques

La fonction WinBioAsyncEnumDatabases 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 l’opération d’énumération réussit, l’infrastructure retourne un tableau de schémas qui incluent des informations sur chaque base de données énumérée. Si l’opération échoue, 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.
Le tableau de schémas est retourné dans une structure EnumDatabases imbriquée à l’intérieur de 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.

L’appel de WinBioAsyncEnumDatabases entraîne l’envoi d’une notification unique à l’application cliente.

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