Funzione WinBioMonitorPresence (winbio.h)
Attiva il meccanismo di riconoscimento facciale o di monitoraggio dell'iris per l'unità biometrica specificata. A partire da Windows 10, build 1607, questa funzione è disponibile per l'uso con un'immagine per dispositivi mobili.
Sintassi
HRESULT WinBioMonitorPresence(
[in] WINBIO_SESSION_HANDLE SessionHandle,
[in] WINBIO_UNIT_ID UnitId
);
Parametri
[in] SessionHandle
Handle asincrono per la sessione biometrica ottenuta chiamando la funzione WinBioAsyncOpenSession con il parametro PoolType impostato su WINBIO_POOL_SYSTEM.
[in] UnitId
Identificatore dell'unità biometrica per cui si vuole attivare il meccanismo di riconoscimento facciale o di monitoraggio dell'iris.
Valore restituito
Se i parametri della funzione sono accettabili, restituisce S_OK. Se i parametri della funzione non sono accettabili, restituisce un valore HRESULT che indica l'errore.
I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente. Per un elenco di codici di errore comuni, vedere Valori HRESULT comuni.
| Codice restituito | Descrizione |
|---|---|
|
L'handle di sessione non è valido. |
|
Il parametro UnitId non può essere uguale a zero. |
|
L'handle di sessione non corrisponde a una sessione biometrica asincrona. |
L'esito effettivo o negativo dell'operazione stessa viene restituito alla funzione di notifica in una struttura WINBIO_ASYNC_RESULT .
Commenti
Una singola sessione biometrica può avere un solo monitoraggio della presenza attiva in qualsiasi momento.
Dopo aver chiamato WinBioMonitorPresence, la funzione di notifica riceve notifiche sotto forma di struttura WINBIO_ASYNC_RESULT con un membro Operation uguale a WINBIO_OPERATION_MONITOR_PRESENCE. È quindi necessario esaminare il membro Parameters.MonitorPresence della struttura WINBIO_ASYNC_RESULT per altre informazioni.
Per interrompere la ricezione delle notifiche, chiamare WinBioCancel o WinBioCloseSession con il valore dell'handle asincrono originale.
Requisiti
| Client minimo supportato | Windows 10 [solo app desktop] |
| Server minimo supportato | Windows Server 2016 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | winbio.h |
| Libreria | Winbio.lib |
| DLL | Winbio.dll |