Partager via

PWINBIO_LOCATE_SENSOR_CALLBACK fonction de rappel (winbio.h)

  • Article

Appelé par l’infrastructure biométrique Windows pour retourner les résultats de la fonction asynchrone WinBioLocateSensorWithCallback . L’application cliente doit implémenter cette fonction.

Important Nous vous recommandons, à compter de Windows 8, de ne plus utiliser la combinaison PWINBIO_LOCATE_SENSOR_CALLBACK/WinBioLocateSensorWithCallback. Au lieu de cela, procédez comme suit :
  • Implémentez une fonction PWINBIO_ASYNC_COMPLETION_CALLBACK pour recevoir une notification à la fin de l’opération.
  • Appelez la fonction WinBioAsyncOpenSession . Transmettez l’adresse de votre rappel dans le paramètre CallbackRoutine . Passez WINBIO_ASYNC_NOTIFY_CALLBACK dans le paramètre NotificationMethod . Récupérer un handle de session asynchrone.
  • Utilisez le handle de session asynchrone pour appeler WinBioLocateSensor. Une fois l’opération terminée, l’infrastructure biométrique Windows alloue et initialise une structure WINBIO_ASYNC_RESULT avec les résultats et appelle votre rappel avec un pointeur vers la structure des résultats.
  • Appelez WinBioFree à partir de votre implémentation de rappel pour libérer la structure WINBIO_ASYNC_RESULT une fois que vous avez terminé de l’utiliser.
 

Syntaxe

PWINBIO_LOCATE_SENSOR_CALLBACK PwinbioLocateSensorCallback;

void PwinbioLocateSensorCallback(
  [in, optional] PVOID LocateCallbackContext,
  [in]           HRESULT OperationStatus,
                 WINBIO_UNIT_ID UnitId
)
{...}

Paramètres

[in, optional] LocateCallbackContext

Pointeur vers une mémoire tampon définie par l’application et passée au paramètre LocateCallbackContext de la fonction WinBioLocateSensorWithCallback . La mémoire tampon n’est pas modifiée par l’infrastructure ou l’unité biométrique. Votre application peut utiliser les données pour l’aider à déterminer les actions à effectuer ou pour conserver des informations supplémentaires sur la capture biométrique.

[in] OperationStatus

Code d’erreur retourné par l’opération de capture.

UnitId

Numéro d’ID d’unité biométrique.

Valeur de retour

None

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible Windows
En-tête winbio.h