Función WinBioAsyncEnumDatabases (winbio.h)

  • Artículo

Enumera de forma asincrónica todas las bases de datos registradas que coinciden con un tipo especificado. Para obtener una versión sincrónica de esta función, consulte WinBioEnumDatabases.

Sintaxis

HRESULT WinBioAsyncEnumDatabases(
  [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 base de datos biométricos 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 success 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 WinBioAsyncEnumDatabases 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 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 base de datos 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, en función del 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 avisos de finalización mediante la cola de mensajes de la aplicación, debe establecer el parámetro NotificationMethod en 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 EnumDatabases 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 WinBioAsyncEnumDatabases , se envía una sola notificación a la aplicación cliente.

Requisitos

Requisito Value
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 (incluya Winbio.h)
Library Winbio.lib
Archivo DLL Winbio.dll

Consulte también

WinBioAsyncOpenFramework