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

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

  • Статья

Асинхронно перечисляет все зарегистрированные базы данных, соответствующие указанному типу. Синхронную версию этой функции см. в разделе WinBioEnumDatabases.

Синтаксис

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

Параметры

[in] FrameworkHandle

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

[in] Factor

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

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

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

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

Комментарии

Функция WinBioAsyncEnumDatabases использует дескриптор для сеанса платформы, открытого путем вызова 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 сообщения окна.
Массив схем возвращается в структуре EnumDatabases , вложенной в структуру WINBIO_ASYNC_RESULT . Чтобы освободить структуру WINBIO_ASYNC_RESULT после завершения использования, необходимо вызвать WinBioFree.

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

Требования

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

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

WinBioAsyncOpenFramework