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

Статья
08/27/2023

Подключается к поставщику биометрических услуг и одной или нескольким биометрическим единицам.

Синтаксис

HRESULT WinBioOpenSession(
  [in]  WINBIO_BIOMETRIC_TYPE Factor,
  [in]  WINBIO_POOL_TYPE      PoolType,
  [in]  WINBIO_SESSION_FLAGS  Flags,
  [in]  WINBIO_UNIT_ID        *UnitArray,
  [in]  SIZE_T                UnitCount,
  [in]  GUID                  *DatabaseId,
  [out] WINBIO_SESSION_HANDLE *SessionHandle
);

Параметры

[in] Factor

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

[in] PoolType

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

Значение	Значение
WINBIO_POOL_SYSTEM	Сеанс подключается к общей коллекции биометрических единиц, управляемых поставщиком услуг.
WINBIO_POOL_PRIVATE	Сеанс подключается к коллекции биометрических единиц, которыми управляет вызывающий объект.

[in] Flags

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

Значение	Значение
WINBIO_FLAG_DEFAULT	Группа: конфигурация Биометрические единицы работают в порядке, указанном во время установки. Это значение необходимо использовать, если параметр PoolType имеет значение WINBIO_POOL_SYSTEM.
WINBIO_FLAG_BASIC	Группа: конфигурация Биометрические единицы работают только в качестве базовых устройств захвата. Все операции обработки, сопоставления и хранения выполняются программными подключаемыми модулями.
WINBIO_FLAG_ADVANCED	Группа: конфигурация Биометрические единицы используют возможности внутренней обработки и хранения.
WINBIO_FLAG_RAW	Группа: доступ Клиентское приложение собирает необработанные биометрические данные с помощью WinBioCaptureSample.
WINBIO_FLAG_MAINTENANCE	Группа: доступ Клиент выполняет определяемые поставщиком операции управления для биометрической единицы, вызывая WinBioControlUnitPrivileged.

[in] UnitArray

Указатель на массив биометрических идентификаторов единиц, которые будут включены в сеанс. Для перечисления биометрических единиц можно вызвать WinBioEnumBiometricUnits . Присвойте этому значению значение NULL , если параметр PoolType имеет WINBIO_POOL_SYSTEM.

[in] UnitCount

Значение типа , указывающее количество элементов в массиве, на который указывает параметр UnitArray . Задайте для этого значения нулевое значение, если параметр PoolTypeWINBIO_POOL_SYSTEM.

[in] DatabaseId

Значение типа , указывающее базы данных, используемые сеансом. Если параметр PoolType имеет WINBIO_POOL_PRIVATE, необходимо указать GUID установленной базы данных. Если параметр PoolType не WINBIO_POOL_PRIVATE, можно указать одно из следующих общих значений.

Значение	Значение
WINBIO_DB_DEFAULT	Каждая биометрическая единица в пуле датчиков использует базу данных по умолчанию, указанную в конфигурации биометрических единиц по умолчанию. Это значение необходимо указать, если параметр PoolType имеет значение WINBIO_POOL_SYSTEM. Это значение нельзя использовать, если параметр PoolType имеет значение WINBIO_POOL_PRIVATE
WINBIO_DB_BOOTSTRAP	Это значение можно указать для сценариев перед запуском Windows. Как правило, база данных является частью микросхемы датчика или частью BIOS и может использоваться только для регистрации и удаления шаблона.
WINBIO_DB_ONCHIP	База данных находится на микросхеме датчика и доступна для регистрации и сопоставления.

[out] SessionHandle

Указатель на новый дескриптор сеанса. Если функция не выполняется, дескриптору присваивается нулевое значение.

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

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

Код возврата	Описание
E_INVALIDARG	Один или несколько аргументов имеют неверные значения или несовместимы с другими аргументами.
E_POINTER	Указатель дескриптора сеанса в параметре SessionHandle не может иметь значение NULL.
E_ACCESSDENIED	Параметр Flags содержит WINBIO_FLAG_RAW или флаг WINBIO_FLAG_MAINTENANCE , а вызывающему объекту не предоставлено ни одно из разрешений на доступ.
WINBIO_E_INVALID_UNIT	Один или несколько биометрических номеров единиц, указанных в параметре UnitArray , недопустимы.
WINBIO_E_NOT_ACTIVE_CONSOLE	Клиентское приложение выполняется на клиенте удаленного рабочего стола и пытается открыть сеанс системного пула.
WINBIO_E_SENSOR_UNAVAILABLE	Параметр PoolType имеет значение WINBIO_POOL_PRIVATE и один или несколько запрошенных датчиков в этом пуле недоступны.
WINBIO_E_DISABLED	Текущая административная политика запрещает использование API Windows Biometric Framework.

Требования


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

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

WinBioCloseSession

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