Funzione WinBioMonitorPresence (winbio.h)

Articolo
08/27/2023

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
E_HANDLE	L'handle di sessione non è valido.
E_INVALIDARG	Il parametro UnitId non può essere uguale a zero.
WINBIO_E_INCORRECT_SESSION_TYPE	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

Vedi anche

WINBIO_ASYNC_RESULT

WinBioAsyncOpenSession

WinBioCancel

WinBioCloseSession

Condividi tramite