Función WinBioAsyncMonitorFrameworkChanges (winbio.h)

  • Artículo

Inicia un monitor asincrónico de cambios en el marco biométrico. Actualmente, los únicos cambios supervisados que se admiten se producen cuando una unidad biométrica está conectada o desasociada del equipo.

Sintaxis

HRESULT WinBioAsyncMonitorFrameworkChanges(
  [in] WINBIO_FRAMEWORK_HANDLE      FrameworkHandle,
  [in] WINBIO_FRAMEWORK_CHANGE_TYPE ChangeTypes
);

Parámetros

[in] FrameworkHandle

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

[in] ChangeTypes

Máscara de bits de tipo WINBIO_FRAMEWORK_CHANGE_TYPE marcas que indican los tipos de eventos que deben generar notificaciones asincrónicas. A partir de Windows 8, está disponible la marca siguiente:

Valor Significado
WINBIO_FRAMEWORK_CHANGE_UNIT
 Se ha conectado o desasociado una unidad biométrica del equipo.

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 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 ChangeTypes contiene uno o varios bits de tipo no válidos. Actualmente, el único valor disponible es WINBIO_FRAMEWORK_CHANGE_UNIT.
WINBIO_E_INCORRECT_SESSION_TYPE
 El argumento FrameworkHandle debe representar una sesión de marco asincrónica.

Comentarios

Una vez iniciado, este monitor seguirá generando eventos hasta que la aplicación cliente llame a WinBioCancel o WinBioCloseFramework. La creación de un monitor para eventos de WINBIO_FRAMEWORK_CHANGE_UNIT generará dos tipos de notificaciones asincrónicas:

Valor Significado
WINBIO_OPERATION_UNIT_ARRIVAL Se adjunta una unidad biométrica.
WINBIO_OPERATION_UNIT_REMOVAL Se desasocia una unidad biométrica.
 

La función WinBioAsyncMonitorFrameworkChanges 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 una unidad biométrica está conectada o desasociada del equipo, el marco establece el miembro Operation de la estructura. Si se produce un problema durante la operación, 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.
Las notificaciones se devuelven 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.

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

Consulte también

WinBioAsyncOpenFramework