Funzione WinBioAsyncEnumServiceProviders (winbio.h)
Restituisce in modo asincrono informazioni sui provider di servizi biometrici installati. A partire da Windows 10, build 1607, questa funzione è disponibile per l'uso con un'immagine per dispositivi mobili. Per una versione sincrona di questa funzione, vedere WinBioEnumServiceProviders.
Sintassi
HRESULT WinBioAsyncEnumServiceProviders(
[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 WINBIO_BIOMETRIC_TYPE flag che specifica i tipi di provider di servizi biometrici da enumerare. Per Windows 8, è 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 della funzione 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 |
|---|---|
|
È necessario impostare l'argomento FrameworkHandle . |
|
La maschera di bit contenuta nel parametro Factor contiene uno o più bit di tipo non validi. |
|
Memoria insufficiente per completare la richiesta. |
|
L'argomento FrameworkHandle deve rappresentare una sessione del framework asincrona. |
Commenti
La funzione WinBioAsyncEnumServiceProviders 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 provider enumerato. 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 chiamata a WinBioAsyncEnumServiceProviders 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 |