Compartir a través de

Función WinBioAsyncEnumServiceProviders (winbio.h)

  • Artículo

Devuelve de forma asincrónica información sobre los proveedores de servicios biométricos instalados. A partir de Windows 10, compilación 1607, esta función está disponible para su uso con una imagen móvil. Para obtener una versión sincrónica de esta función, consulte WinBioEnumServiceProviders.

Sintaxis

HRESULT WinBioAsyncEnumServiceProviders(
  [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 proveedor de servicios biométricos que se van a enumerar. Para Windows 8, 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 de la función 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_INCORRECT_SESSION_TYPE
 El argumento FrameworkHandle debe representar una sesión de marco asincrónica.

Comentarios

La función WinBioAsyncEnumServiceProviders 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 proveedor enumerado. 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 EnumServiceProviders 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.

Llamar a WinBioAsyncEnumServiceProviders hace que se envíe una sola 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