Condividi tramite

PWINBIO_LOCATE_SENSOR_CALLBACK funzione di callback (winbio.h)

  • Articolo

Chiamato da Windows Biometric Framework per restituire i risultati dalla funzione asincrona WinBioLocateSensorWithCallback . L'applicazione client deve implementare questa funzione.

Importante È consigliabile, a partire da Windows 8, non usare più la combinazione di PWINBIO_LOCATE_SENSOR_CALLBACK/WinBioLocateSensorWithCallback. Eseguire invece le operazioni seguenti:
  • Implementare una funzione PWINBIO_ASYNC_COMPLETION_CALLBACK per ricevere un avviso al termine dell'operazione.
  • Chiamare la funzione WinBioAsyncOpenSession . Passare l'indirizzo del callback nel parametro CallbackRoutine . Passare WINBIO_ASYNC_NOTIFY_CALLBACK nel parametro NotificationMethod . Recuperare un handle di sessione asincrono.
  • Usare l'handle di sessione asincrono per chiamare WinBioLocateSensor. Al termine dell'operazione, Windows Biometric Framework allocherà e inizializzerà una struttura WINBIO_ASYNC_RESULT con i risultati e richiamerà il callback con un puntatore alla struttura dei risultati.
  • Chiama WinBioFree dall'implementazione del callback per rilasciare la struttura WINBIO_ASYNC_RESULT al termine dell'uso.
 

Sintassi

PWINBIO_LOCATE_SENSOR_CALLBACK PwinbioLocateSensorCallback;

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

Parametri

[in, optional] LocateCallbackContext

Puntatore a un buffer definito dall'applicazione e passato al parametro LocateCallbackContext della funzione WinBioLocateSensorWithCallback . Il buffer non viene modificato dal framework o dall'unità biometrica. L'applicazione può usare i dati per determinare quali azioni eseguire o mantenere informazioni aggiuntive sull'acquisizione biometrica.

[in] OperationStatus

Codice di errore restituito dall'operazione di acquisizione.

UnitId

Numero ID unità biometrica.

Valore restituito

nessuno

Requisiti

Requisito Valore
Client minimo supportato Windows 7 [solo app desktop]
Server minimo supportato Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione winbio.h