Funzione WinBioAsyncEnumDatabases (winbio.h)

Articolo
08/27/2023

Enumera in modo asincrono tutti i database registrati che corrispondono a un tipo specificato. Per una versione sincrona di questa funzione, vedere WinBioEnumDatabases.

Sintassi

HRESULT WinBioAsyncEnumDatabases(
  [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 database biometrici 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 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
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_INCORRECT_SESSION_TYPE	L'argomento FrameworkHandle deve rappresentare una sessione del framework asincrona.

Commenti

La funzione WinBioAsyncEnumDatabases 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 database 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 matrice di schemi viene restituita in una struttura EnumDatabases 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 WinBioAsyncEnumDatabases causa l'invio di una singola notifica all'applicazione client.

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

Vedi anche

WinBioAsyncOpenFramework

Condividi tramite