Funzione WinBioAsyncMonitorFrameworkChanges (winbio.h)
Avvia un monitoraggio asincrono delle modifiche apportate al framework biometrico. Attualmente, le uniche modifiche monitorate supportate si verificano quando un'unità biometrica è collegata o scollegata dal computer.
Sintassi
HRESULT WinBioAsyncMonitorFrameworkChanges(
[in] WINBIO_FRAMEWORK_HANDLE FrameworkHandle,
[in] WINBIO_FRAMEWORK_CHANGE_TYPE ChangeTypes
);
Parametri
[in] FrameworkHandle
Gestire la sessione del framework aperta chiamando WinBioAsyncOpenFramework.
[in] ChangeTypes
Maschera di bit di tipo WINBIO_FRAMEWORK_CHANGE_TYPE flag che indica i tipi di eventi che devono generare notifiche asincrone. A partire da Windows 8, è disponibile il flag seguente:
| Valore | Significato |
|---|---|
|
Un'unità biometrica è stata collegata o scollegata dal computer. |
Valore restituito
La funzione restituisce un valore HRESULT che indica l'esito positivo o negativo. Si noti che l'esito positivo indica solo che gli argomenti della funzione sono validi. Gli errori rilevati durante l'esecuzione dell'operazione verranno restituiti in modo asincrono a una struttura WINBIO_ASYNC_RESULT usando il metodo di notifica specificato in WinBioAsyncOpenFramework.
| Codice restituito | Descrizione |
|---|---|
|
È necessario impostare l'argomento FrameworkHandle . |
|
La maschera di bit contenuta nel parametro ChangeTypes contiene uno o più bit di tipo non validi. Attualmente, l'unico valore disponibile è WINBIO_FRAMEWORK_CHANGE_UNIT. |
|
L'argomento FrameworkHandle deve rappresentare una sessione del framework asincrona. |
Commenti
Una volta avviato, questo monitoraggio continuerà a generare eventi fino a quando l'applicazione client chiama WinBioCancel o WinBioCloseFramework. La creazione di un monitoraggio per gli eventi WINBIO_FRAMEWORK_CHANGE_UNIT genererà due tipi di notifiche asincrone:
| Valore | Significato |
|---|---|
| WINBIO_OPERATION_UNIT_ARRIVAL | È collegata un'unità biometrica. |
| WINBIO_OPERATION_UNIT_REMOVAL | Un'unità biometrica viene scollegata. |
La funzione WinBioAsyncMonitorFrameworkChanges usa un handle per la sessione del framework aperta chiamando WinBioAsyncOpenFramework. Il framework alloca una struttura WINBIO_ASYNC_RESULT e la usa per restituire informazioni sull'esito positivo o negativo dell'operazione. Se un'unità biometrica è collegata o scollegata dal computer, il framework imposta il membro Operation della struttura. Se si verifica un problema durante l'operazione, il framework usa la struttura WINBIO_ASYNC_RESULT per restituire informazioni sull'errore. La struttura viene restituita al callback dell'applicazione o alla coda dei messaggi dell'applicazione, a seconda del valore impostato nel parametro NotificationMethod della funzione WinBioAsyncOpenFramework .
- Se si sceglie di ricevere avvisi di completamento usando un callback, è necessario implementare una funzione PWINBIO_ASYNC_COMPLETION_CALLBACK e impostare il parametro NotificationMethod su WINBIO_ASYNC_NOTIFY_CALLBACK.
- Se si sceglie di ricevere avvisi di completamento usando la coda dei messaggi dell'applicazione, è necessario impostare il parametro NotificationMethod su WINBIO_ASYNC_NOTIFY_MESSAGE. Il framework restituisce un puntatore WINBIO_ASYNC_RESULT al campo LPARAM del messaggio della finestra.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 8 [solo app desktop] |
| Server minimo supportato | Windows Server 2012 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | winbio.h (include Winbio.h) |
| Libreria | Winbio.lib |
| DLL | Winbio.dll |