Función WinBioEnrollSelect (winbio.h)

Artículo
03/09/2024

Especifica la persona que desea inscribir cuando los datos que representan a varias personas están presentes en el búfer de ejemplo. A partir de Windows 10, compilación 1607, esta función está disponible para su uso con una imagen móvil.

Sintaxis

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

Parámetros

[in] SessionHandle

Valor WINBIO_SESSION_HANDLE que identifica una sesión biométrica abierta. Abra un identificador de sesión sincrónico llamando a WinBioOpenSession. Abra un identificador de sesión asincrónico llamando a WinBioAsyncOpenSession.

Para la inscripción en el reconocimiento facial, use WinBioAsyncOpenSession con el parámetro PoolType establecido en WINBIO_POOL_SYSTEM para obtener el identificador.

[in] SelectorValue

Valor que identifica a esa persona que desea seleccionar para la inscripción.

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_HANDLE	El identificador de sesión no es válido.
E_INVALIDARG	El parámetro SelectorValue no puede ser igual a cero.
WINBIO_E_INCORRECT_SESSION_TYPE	El identificador de sesión no se corresponde con una sesión biométrica.

Comentarios

Para la inscripción en el reconocimiento facial, puede encontrar el valor de selector correcto de dos maneras:

Valor del miembro Id de una de las estructuras de WINBIO_PRESENCE enviadas anteriormente.
Los datos generados por las API de seguimiento facial de NUI.

Llame a WinBioEnrollSelect para establecer el valor del selector después de llamar a WinBioEnrollBegin para iniciar una secuencia de inscripción. El valor del selector se aplica a todas las llamadas posteriores de WinBioEnrollCapture . La configuración de selección es temporal y se borra automáticamente al finalizar la secuencia de inscripción mediante una llamada a WinBioEnrollCommit o WinBioEnrollDiscard.

Si llamas a WinBioEnrollSelect para los factores biométricos que no requieren la desambiguación, como las huellas digitales, el valor devuelto de la función indica que la función se ha realizado correctamente, pero la función omite el valor del selector.

Si no llamas a WinBioEnrollSelect para un factor biométrico que requiere que llames a la función, las llamadas posteriores a WinBioEnrollCapture producirán el error WINBIO_E_SELECTION_REQUIRED .

Por Windows 10, los factores que requieren que llames a WinBioEnrollSelect son características faciales e iris.

Puede llamar a WinBioEnrollSelect mediante un identificador de sesión sincrónico o asincrónico. Al igual que con otras llamadas a las funciones de la API de Windows Biometric Framework, cuando se llama a WinBioEnrollSelect con un identificador de sesión asincrónico, el valor devuelto indica solo que los parámetros de función eran aceptables. El éxito o error reales de la operación en sí se devolverá a la rutina de notificación en una estructura de WINBIO_ASYNC_RESULT .

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