Función WinBioEnrollSelect (winbio.h)

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 usarla con una imagen móvil.

Syntax

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 ejecuta 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, entre otros, los de la tabla siguiente. Para obtener una lista de códigos de error comunes, consulte Valores HRESULT comunes.

Observaciones

Para la inscripción en el reconocimiento facial, puede encontrar el valor del 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 nuI.

Si llama a WinBioEnrollSelect para los factores biométricos que no requieren desambiguación, como 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 .

Para 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 real o el error de la propia operación se devolverán a la rutina de notificación en una estructura de WINBIO_ASYNC_RESULT .

Requisitos

Consulte también

WINBIO_ASYNC_RESULT

WINBIO_PRESENCE

WinBioEnrollBegin

WinBioEnrollCapture

WinBioEnrollCommit

WinBioEnrollDiscard