Compartir a través de


Función WinBioAsyncMonitorFrameworkChanges (winbio.h)

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