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

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

  • Статья

Асинхронно возвращает сведения об установленных поставщиках биометрических услуг. Начиная с Windows 10 сборки 1607 эта функция доступна для использования с мобильным образом. Синхронную версию этой функции см. в разделе WinBioEnumServiceProviders.

Синтаксис

HRESULT WinBioAsyncEnumServiceProviders(
  [in] WINBIO_FRAMEWORK_HANDLE FrameworkHandle,
  [in] WINBIO_BIOMETRIC_TYPE   Factor
);

Параметры

[in] FrameworkHandle

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

[in] Factor

Битовая маска флагов WINBIO_BIOMETRIC_TYPE , указывающая перечислимые типы поставщиков биометрических служб. В Windows 8 поддерживаются только WINBIO_TYPE_FINGERPRINT .

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

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

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

Комментарии

Функция WinBioAsyncEnumServiceProviders использует дескриптор для сеанса платформы, открытого путем вызова WinBioAsyncOpenFramework. Платформа выделяет структуру WINBIO_ASYNC_RESULT и использует ее для возврата сведений об успешном или неудачном выполнении операции. Если операция перечисления выполнена успешно, платформа возвращает массив схем, включающих сведения о каждом перечислимом поставщике. Если операция не выполнена, платформа использует структуру 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 после завершения ее использования.

Вызов WinBioAsyncEnumServiceProviders приводит к отправке одного уведомления в клиентское приложение.

Требования

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

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

WinBioAsyncOpenFramework