Función WinBioGetEnrolledFactors (winbio.h)

Obtiene información sobre las inscripciones biométricas que el usuario especificado tiene en el equipo. Las inscripciones biométricas incluyen inscripciones para el reconocimiento facial, el examen de huellas digitales, el examen de iris, etc.

Sintaxis

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

Parámetros

[in] AccountOwner

Estructura de WINBIO_IDENTITY para el usuario cuyas inscripciones biométricas desea obtener. Por ejemplo:

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

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

Para ver las inscripciones de cada usuario del equipo, especifique el tipo de identidad WINBIO_ID_TYPE_WILDCARD para la estructura de WINBIO_IDENTITY que especifique para el parámetro AccountOwner . Por ejemplo:

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

[out] EnrolledFactors

Conjunto de marcas de WINBIO_BIOMETRIC_TYPE que indican las inscripciones biométricas que el usuario especificado tiene en el equipo. Un valor de 0 indica que el usuario no tiene inscripciones biométricas.

Estas inscripciones solo representan inscripciones del grupo de sistemas, como las inscripciones que puede usar para autenticar a un usuario para el inicio de sesión, el desbloqueo, etc. Este valor no incluye inscripciones de grupos privados.

Si especifica el tipo de identidad comodín para la estructura de WINBIO_IDENTITY que usa para el parámetro AccountOwner , este conjunto de marcas representa el conjunto combinado de inscripciones para todos los usuarios con cuentas en el equipo.

Valor devuelto

Si la función se realiza correctamente, devuelve S_OK. Si se produce un error en la función, devuelve un valor HRESULT que indica el error. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros. Para obtener una lista de códigos de error comunes, consulte Valores HRESULT comunes.

Código devuelto	Descripción
E_POINTER	Los parámetros AccountOwner y EnrolledFactors no pueden ser NULL.
E_INVALIDARG	El miembro Type de la estructura WINBIO_IDENTITY que el parámetro AccountOnwer especificado no era WINBIO_ID_TYPE_SID o WINBIO_ID_TYPE_WILDCARD, o el miembro AccountSid de la estructura WINBIO_IDENTITY no era válido.

Comentarios

WinBioGetEnrolledFactors no requiere un identificador de sesión biométrica y no activa el servicio biométrico. Por lo tanto, WinBioGetEnrolledFactors se ejecuta rápidamente y es útil cuando el código necesita tomar decisiones rápidas sobre cómo continuar cuando el tiempo es fundamental para el conjunto de operaciones que necesita realizar.

WinBioGetEnrolledFactors proporciona a los proveedores de credenciales una manera de adaptar su interfaz de usuario de forma adecuada. Por ejemplo, la pantalla de inicio de sesión llama a WinBioGetEnrolledFactors para determinar si se debe mostrar la opción para iniciar sesión con una huella digital.

Ejemplos

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);

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 10 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2016 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	winbio.h
Library	Winbio.lib
Archivo DLL	Winbio.dll

Consulte también

WINBIO_BIOMETRIC_TYPE

WINBIO_IDENTITY