Compartir a través de

Función WinBioAsyncEnumBiometricUnits (winbio.h)

  • Artículo

Enumera de forma asincrónica todas las unidades biométricas adjuntas que coinciden con el tipo de factor de entrada. Para obtener una versión sincrónica de esta función, consulte WinBioEnumBiometricUnits. A partir de Windows 10, compilación 1607, esta función está disponible para su uso con una imagen móvil.

Sintaxis

HRESULT WinBioAsyncEnumBiometricUnits(
  [in] WINBIO_FRAMEWORK_HANDLE FrameworkHandle,
  [in] WINBIO_BIOMETRIC_TYPE   Factor
);

Parámetros

[in] FrameworkHandle

Controle la sesión del marco abierta llamando a WinBioAsyncOpenFramework.

[in] Factor

Máscara de bits de marcas de WINBIO_BIOMETRIC_TYPE que especifica los tipos de unidad biométrica que se van a enumerar. Actualmente solo se admite WINBIO_TYPE_FINGERPRINT .

Valor devuelto

La función devuelve un VALOR HRESULT que indica que se ha realizado correctamente o no. Tenga en cuenta que correcto indica solo que los argumentos eran válidos. Los errores detectados durante la ejecución de la operación se devolverán de forma asincrónica a una estructura de WINBIO_ASYNC_RESULT mediante el método de notificación especificado en la llamada a WinBioAsyncOpenFramework.

Código devuelto Descripción
E_HANDLE
 Debe establecer el argumento FrameworkHandle .
E_INVALIDARG
 La máscara de bits contenida en el parámetro Factor contiene uno o varios bits de tipo no válidos.
E_OUTOFMEMORY
 No había memoria suficiente para completar la solicitud.
WINBIO_E_DISABLED
 La directiva administrativa actual prohíbe el uso de la API de Windows Biometric Framework.
WINBIO_E_INCORRECT_SESSION_TYPE
 El argumento FrameworkHandle debe representar una sesión de marco asincrónica.
WINBIO_E_SESSION_HANDLE_CLOSED
 El identificador de sesión se ha marcado para el cierre.

Comentarios

La función WinBioAsyncEnumBiometricUnits usa un identificador para la sesión de marco abierta mediante una llamada a WinBioAsyncOpenFramework. El marco asigna una estructura de WINBIO_ASYNC_RESULT y la usa para devolver información sobre el éxito o el error de la operación. Si la operación de enumeración se realiza correctamente, el marco devuelve una matriz de esquemas que incluyen información sobre cada unidad biométrica enumerada. Si la operación no se realiza correctamente, el marco usa la estructura WINBIO_ASYNC_RESULT para devolver información de error. La estructura se devuelve a la devolución de llamada de la aplicación o a la cola de mensajes de la aplicación, según el valor establecido en el parámetro NotificationMethod de la función WinBioAsyncOpenFramework .

  • Si decide recibir avisos de finalización mediante una devolución de llamada, debe implementar una función de PWINBIO_ASYNC_COMPLETION_CALLBACK y establecer el parámetro NotificationMethod en WINBIO_ASYNC_NOTIFY_CALLBACK.
  • Si decide recibir notificaciones de finalización mediante la cola de mensajes de la aplicación, debe establecer el parámetro NotificationMethoden WINBIO_ASYNC_NOTIFY_MESSAGE. El marco devuelve un puntero WINBIO_ASYNC_RESULT al campo LPARAM del mensaje de ventana.
La matriz de esquemas se devuelve en una estructura EnumBiometricUnits anidada dentro de la estructura WINBIO_ASYNC_RESULT . Debe llamar a WinBioFree para liberar la estructura de WINBIO_ASYNC_RESULT una vez que haya terminado de usarlo.

Al llamar a WinBioAsyncEnumBiometricUnits , se envía una única notificación a la aplicación cliente.

Requisitos

   
Cliente mínimo compatible Windows 8 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2012 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado winbio.h (incluye Winbio.h)
Library Winbio.lib
Archivo DLL Winbio.dll

Consulte también

WinBioAsyncOpenFramework