Поделиться через

Функция WinBioAsyncMonitorFrameworkChanges (winbio.h)

  • Статья

Запускает асинхронный мониторинг изменений в биометрической платформе. В настоящее время единственные поддерживаемые отслеживаемые изменения происходят, когда биометрическая единица подключена к компьютеру или отсоединяется от нее.

Синтаксис

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

Параметры

[in] FrameworkHandle

Обработка сеанса платформы, открытого путем вызова WinBioAsyncOpenFramework.

[in] ChangeTypes

Битовая маска типа WINBIO_FRAMEWORK_CHANGE_TYPE флаги, указывающие типы событий, которые должны создавать асинхронные уведомления. Начиная с Windows 8 доступен следующий флаг:

Значение Значение
WINBIO_FRAMEWORK_CHANGE_UNIT
 Биометрический блок подключен к компьютеру или отсоединился от него.

Возвращаемое значение

Функция возвращает HRESULT , указывающее на успешное или неудачное выполнение. Обратите внимание, что успех указывает только на то, что аргументы функции были допустимыми. Сбои, возникшие во время выполнения операции, будут асинхронно возвращены в структуру WINBIO_ASYNC_RESULT с помощью метода уведомления, указанного в WinBioAsyncOpenFramework.

Код возврата Описание
E_HANDLE
 Необходимо задать аргумент FrameworkHandle .
E_INVALIDARG
 Битовая маска, содержащаяся в параметре ChangeTypes , содержит один или несколько битов недопустимого типа. В настоящее время единственным доступным значением является WINBIO_FRAMEWORK_CHANGE_UNIT.
WINBIO_E_INCORRECT_SESSION_TYPE
 Аргумент FrameworkHandle должен представлять асинхронный сеанс платформы.

Комментарии

После запуска этот монитор будет продолжать создавать события, пока клиентское приложение не вызовет WinBioCancel или WinBioCloseFramework. Создание монитора для WINBIO_FRAMEWORK_CHANGE_UNIT событий приведет к созданию двух типов асинхронных уведомлений:

Значение Значение
WINBIO_OPERATION_UNIT_ARRIVAL Прикрепляется биометрический блок.
WINBIO_OPERATION_UNIT_REMOVAL Биометрическая единица отсоединяется.
 

Функция WinBioAsyncMonitorFrameworkChanges использует дескриптор для сеанса платформы, открытого путем вызова WinBioAsyncOpenFramework. Платформа выделяет структуру WINBIO_ASYNC_RESULT и использует ее для возврата сведений об успешном или неудачном выполнении операции. Если биометрическая единица подключена к компьютеру или отсоединяется от нее, платформа задает элемент Operation структуры. Если во время операции возникла проблема, платформа использует структуру WINBIO_ASYNC_RESULT для возврата сведений об ошибке. Структура возвращается обратному вызову приложения или в очередь сообщений приложения в зависимости от значения, заданного в параметре NotificationMethod функции WinBioAsyncOpenFramework .

  • Если вы решили получать уведомления о завершении с помощью обратного вызова, необходимо реализовать функцию PWINBIO_ASYNC_COMPLETION_CALLBACK и задать для параметра NotificationMethodзначение WINBIO_ASYNC_NOTIFY_CALLBACK.
  • Если вы решили получать уведомления о завершении с помощью очереди сообщений приложения, необходимо задать для параметра NotificationMethodзначение WINBIO_ASYNC_NOTIFY_MESSAGE. Платформа возвращает указатель WINBIO_ASYNC_RESULT на поле LPARAM сообщения окна.
Уведомления возвращаются в структуре EnumServiceProviders , вложенной в структуру WINBIO_ASYNC_RESULT . Необходимо вызвать WinBioFree , чтобы освободить структуру WINBIO_ASYNC_RESULT после завершения ее использования.

Требования

Требование Значение
Минимальная версия клиента Windows 8 [только классические приложения]
Минимальная версия сервера Windows Server 2012 [только классические приложения]
Целевая платформа Windows
Header winbio.h (включая Winbio.h)
Библиотека Winbio.lib
DLL Winbio.dll

См. также раздел

WinBioAsyncOpenFramework