Funzione WinBioEnrollSelect (winbio.h)

Articolo
08/27/2023

Specifica l'utente che si desidera registrare quando i dati che rappresentano più singoli utenti sono presenti nel buffer di esempio. A partire da Windows 10, build 1607, questa funzione è disponibile per l'uso con un'immagine per dispositivi mobili.

Sintassi

HRESULT WinBioEnrollSelect(
  [in] WINBIO_SESSION_HANDLE SessionHandle,
  [in] ULONGLONG             SelectorValue
);

Parametri

[in] SessionHandle

Valore WINBIO_SESSION_HANDLE che identifica una sessione biometrica aperta. Aprire un handle di sessione sincrono chiamando WinBioOpenSession. Aprire un handle di sessione asincrono chiamando WinBioAsyncOpenSession.

Per la registrazione nel riconoscimento facciale, usare WinBioAsyncOpenSession con il parametro PoolType impostato su WINBIO_POOL_SYSTEM per ottenere l'handle.

[in] SelectorValue

Valore che identifica l'utente che si vuole selezionare per la registrazione.

Valore restituito

Se la funzione ha esito positivo, restituisce S_OK. Se la funzione ha esito negativo, 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 dei codici di errore comuni, vedere Valori HRESULT comuni.

Codice restituito	Descrizione
E_HANDLE	L'handle di sessione non è valido.
E_INVALIDARG	Il parametro SelectorValue non può essere uguale a zero.
WINBIO_E_INCORRECT_SESSION_TYPE	L'handle di sessione non corrisponde a una sessione biometrica.

Commenti

Per la registrazione nel riconoscimento facciale, è possibile trovare il valore del selettore corretto in uno dei due modi seguenti:

Valore del membro Id di una delle strutture WINBIO_PRESENCE inviate in precedenza.
I dati prodotti dalle API di rilevamento dei visi NUI.

Chiama WinBioEnrollSelect per impostare il valore del selettore dopo aver chiamato WinBioEnrollBegin per avviare una sequenza di registrazione. Il valore del selettore si applica a tutte le chiamate WinBioEnrollCapture successive. L'impostazione di selezione è temporanea e viene cancellata automaticamente al termine della sequenza di registrazione chiamando WinBioEnrollCommit o WinBioEnrollDiscard.

Se chiami WinBioEnrollSelect per i fattori biometrici che non richiedono ambiguità, ad esempio le impronte digitali, il valore restituito per la funzione indica l'esito positivo, ma la funzione ignora il valore del selettore.

Se non chiami WinBioEnrollSelect per un fattore biometrico che richiede di chiamare la funzione, le chiamate successive a WinBioEnrollCapture hanno esito negativo con l'errore WINBIO_E_SELECTION_REQUIRED .

Per Windows 10, i fattori che richiedono di chiamare WinBioEnrollSelect sono caratteristiche facciali e iris.

Puoi chiamare WinBioEnrollSelect usando un handle di sessione sincrono o asincrono. Come per altre chiamate alle funzioni API di Windows Biometric Framework, quando chiami WinBioEnrollSelect con un handle di sessione asincrono, il valore restituito indica solo che i parametri della funzione erano accettabili. L'esito positivo o negativo effettivo dell'operazione stessa verrà restituito alla routine di notifica in una struttura di WINBIO_ASYNC_RESULT .

Requisiti

Requisito	Valore
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