Funzione WinBioAsyncEnumBiometricUnits (winbio.h)

Articolo
08/27/2023

Enumera in modo asincrono tutte le unità biometriche associate che corrispondono al tipo di fattore di input. Per una versione sincrona di questa funzione, vedere WinBioEnumBiometricUnits. A partire da Windows 10, build 1607, questa funzione è disponibile per l'uso con un'immagine per dispositivi mobili.

Sintassi

HRESULT WinBioAsyncEnumBiometricUnits(
  [in] WINBIO_FRAMEWORK_HANDLE FrameworkHandle,
  [in] WINBIO_BIOMETRIC_TYPE   Factor
);

Parametri

[in] FrameworkHandle

Gestire la sessione del framework aperta chiamando WinBioAsyncOpenFramework.

[in] Factor

Maschera di bit di flag WINBIO_BIOMETRIC_TYPE che specifica i tipi di unità biometrica da enumerare. Attualmente è supportato solo WINBIO_TYPE_FINGERPRINT .

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 sono validi. Gli errori riscontrati durante l'esecuzione dell'operazione verranno restituiti in modo asincrono a una struttura WINBIO_ASYNC_RESULT usando il metodo di notifica specificato nella chiamata a WinBioAsyncOpenFramework.

Codice restituito	Descrizione
E_HANDLE	È necessario impostare l'argomento FrameworkHandle .
E_INVALIDARG	La maschera di bit contenuta nel parametro Factor contiene uno o più bit di tipo non validi.
E_OUTOFMEMORY	Memoria insufficiente per completare la richiesta.
WINBIO_E_DISABLED	I criteri amministrativi correnti impediscono l'uso dell'API Di Windows Biometric Framework.
WINBIO_E_INCORRECT_SESSION_TYPE	L'argomento FrameworkHandle deve rappresentare una sessione del framework asincrona.
WINBIO_E_SESSION_HANDLE_CLOSED	L'handle di sessione è stato contrassegnato per la chiusura.

Commenti

La funzione WinBioAsyncEnumBiometricUnits 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 l'operazione di enumerazione ha esito positivo, il framework restituisce una matrice di schemi che includono informazioni su ogni unità biometrica enumerata. Se l'operazione non riesce, 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.

La matrice di schemi viene restituita in una struttura EnumBiometricUnits annidata all'interno della struttura WINBIO_ASYNC_RESULT . Devi chiamare WinBioFree per rilasciare la struttura WINBIO_ASYNC_RESULT dopo aver finito di usarla.

La chiamata a WinBioAsyncEnumBiometricUnits causa l'invio di una singola notifica all'applicazione client.

Requisiti


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

Vedi anche

WinBioAsyncOpenFramework

Condividi tramite