Funzione WinBioGetEnrolledFactors (winbio.h)

Articolo
08/27/2023

Ottiene informazioni sulle registrazioni biometriche che l'utente specificato ha nel computer. Le registrazioni biometriche includono registrazioni per il riconoscimento facciale, l'analisi delle impronte digitali, l'analisi dell'iris e così via.

Sintassi

HRESULT WinBioGetEnrolledFactors(
  [in]  WINBIO_IDENTITY       *AccountOwner,
  [out] WINBIO_BIOMETRIC_TYPE *EnrolledFactors
);

Parametri

[in] AccountOwner

Struttura WINBIO_IDENTITY per l'utente la cui registrazione biometrica si vuole ottenere. Ad esempio:

WINBIO_IDENTITY identity = {};
identity.Type = WINBIO_ID_TYPE_SID;

// Move an account SID into identity.Value.AccountSid.Data.
// For example, CopySid(...)

Per visualizzare le registrazioni per ogni utente nel computer, specificare il tipo di identità WINBIO_ID_TYPE_WILDCARDper la struttura WINBIO_IDENTITY specificata per il parametro AccountOwner . Ad esempio:

WINBIO_IDENTITY identity = {};
identity.Type = WINBIO_ID_TYPE_WILDCARD;

[out] EnrolledFactors

Set di flag di WINBIO_BIOMETRIC_TYPE che indicano le registrazioni biometriche che l'utente specificato ha nel computer. Un valore pari a 0 indica che l'utente non ha registrazioni biometriche.

Queste registrazioni rappresentano solo le registrazioni del pool di sistema, ad esempio le registrazioni che è possibile usare per autenticare un utente per l'accesso, lo sblocco e così via. Questo valore non include le registrazioni del pool privato.

Se si specifica il tipo di identità jolly per la struttura WINBIO_IDENTITY usata per il parametro AccountOwner , questo set di flag rappresenta il set combinato di registrazioni per tutti gli utenti con account nel computer.

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 di codici di errore comuni, vedere Valori HRESULT comuni.

Codice restituito	Descrizione
E_POINTER	I parametri AccountOwner e EnrolledFactors non possono essere NULL.
E_INVALIDARG	Il membro Type della struttura WINBIO_IDENTITY che il parametro AccountOnwer specificato non è stato WINBIO_ID_TYPE_SIDo WINBIO_ID_TYPE_WILDCARD o il membro AccountSiddella struttura WINBIO_IDENTITY non è valido.

Commenti

WinBioGetEnrolledFactors non richiede un handle di sessione biometrico e non attiva il servizio biometrico. Di conseguenza, WinBioGetEnrolledFactors viene eseguito rapidamente ed è utile quando il codice deve prendere decisioni rapide su come procedere quando il tempo è fondamentale per il set di operazioni da eseguire.

WinBioGetEnrolledFactors offre ai provider di credenziali un modo per personalizzare l'interfaccia utente in modo appropriato. Ad esempio, la schermata di accesso chiama WinBioGetEnrolledFactors per determinare se visualizzare l'opzione per accedere con un'impronta digitale.

Esempio

WINBIO_BIOMETRIC_TYPE enrolledFactors = WINBIO_NO_TYPE_AVAILABLE;

WINBIO_IDENTITY identity = {};
identity.Type = WINBIO_ID_TYPE_SID;

// Move an account SID into identity.Value.AccountSid.Data.
// e.g., CopySid(...)

HRESULT hr = WinBioGetEnrolledFactors(&identity, &enrolledFactors);

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

Vedi anche

WINBIO_BIOMETRIC_TYPE

WINBIO_IDENTITY

Condividi tramite