структура WINBIO_EVENT
Структура WINBIO_EVENT содержит сведения о состоянии, отправляемые подпрограмме обратного вызова при появлении уведомления о событии.
Синтаксис
typedef struct _WINBIO_EVENT {
WINBIO_EVENT_TYPE Type;
union {
struct {
WINBIO_UNIT_ID UnitId;
WINBIO_REJECT_DETAIL RejectDetail;
} Unclaimed;
struct {
WINBIO_UNIT_ID UnitId;
WINBIO_IDENTITY Identity;
WINBIO_BIOMETRIC_SUBTYPE SubFactor;
WINBIO_REJECT_DETAIL RejectDetail;
} UnclaimedIdentify;
struct {
HRESULT ErrorCode;
} Error;
} Parameters;
} WINBIO_EVENT, *PWINBIO_EVENT;
Члены
-
Тип
-
Значение типа , указывающее тип уведомления о событии поставщика услуг. Единственным поставщиком, который в настоящее время поддерживается, является датчик отпечатков пальцев. Этот датчик поддерживает следующие флаги.
-
WINBIO_EVENT_FP_UNCLAIMED (датчик обнаружил прокрутку пальца, которая не была запрошена приложением или окном, которое в настоящее время находится в фокусе. Windows Biometric Framework вызывает функцию обратного вызова, чтобы указать, что произошло прокрутка пальцами, но не пытается идентифицировать отпечаток пальца.)
-
WINBIO_EVENT_FP_UNCLAIMED_IDENTIFY (датчик обнаружил прокрутку пальца, которая не была запрошена приложением или окном, которое в настоящее время находится в фокусе. Windows Biometric Framework пытается идентифицировать отпечаток пальца и передает результат этого процесса в функцию обратного вызова.)
-
-
Параметры
-
-
Невостребованных
-
Структура, возвращаемая для биометрической выборки.
-
UnitId
-
Биометрическая единица, создающая образец.
-
RejectDetail
-
Значение ULONG , содержащее дополнительные сведения о невозможности записать биометрическую выборку. Если запись выполнена успешно, для этого параметра устанавливается нулевое значение. Для захвата отпечатков пальцев определяются следующие значения:
- WINBIO_FP_TOO_HIGH
- WINBIO_FP_TOO_LOW
- WINBIO_FP_TOO_LEFT
- WINBIO_FP_TOO_RIGHT
- WINBIO_FP_TOO_FAST
- WINBIO_FP_TOO_SLOW
- WINBIO_FP_POOR_QUALITY
- WINBIO_FP_TOO_SKEWED
- WINBIO_FP_TOO_SHORT
- WINBIO_FP_MERGE_FAILURE
-
-
UnclaimedIdentify
-
Структура, возвращаемая для биометрической записи и идентификации. Идентификация определяет, можно ли связать образец с существующим биометрическим шаблоном.
-
UnitId
-
Биометрическая единица, создающая образец.
-
Удостоверение
-
Структура WINBIO_IDENTITY , содержащая GUID или идентификатор безопасности пользователя, предоставляющего биометрическую выборку.
-
Субфакторинг
-
Значение WINBIO_BIOMETRIC_SUBTYPE , указывающее подфактор, связанный с биометрической выборкой. Windows Biometric Framework (WBF) в настоящее время поддерживает только захват отпечатков пальцев и использует следующие константы для представления сведений о подтипе.
- WINBIO_ANSI_381_POS_UNKNOWN
- WINBIO_ANSI_381_POS_RH_THUMB
- WINBIO_ANSI_381_POS_RH_INDEX_FINGER
- WINBIO_ANSI_381_POS_RH_MIDDLE_FINGER
- WINBIO_ANSI_381_POS_RH_RING_FINGER
- WINBIO_ANSI_381_POS_RH_LITTLE_FINGER
- WINBIO_ANSI_381_POS_LH_THUMB
- WINBIO_ANSI_381_POS_LH_INDEX_FINGER
- WINBIO_ANSI_381_POS_LH_MIDDLE_FINGER
- WINBIO_ANSI_381_POS_LH_RING_FINGER
- WINBIO_ANSI_381_POS_LH_LITTLE_FINGER
- WINBIO_ANSI_381_POS_RH_FOUR_FINGERS
- WINBIO_ANSI_381_POS_LH_FOUR_FINGERS
- WINBIO_ANSI_381_POS_TWO_THUMBS
Важно!
Не пытайтесь проверить значение, предоставленное для значения SubFactor . Служба биометрических данных Windows проверит предоставленное значение перед его передачей в реализацию. Если значение равно WINBIO_SUBTYPE_NO_INFORMATION или WINBIO_SUBTYPE_ANY, проверьте, где это необходимо.
-
RejectDetail
-
Значение ULONG , содержащее дополнительные сведения о невозможности захвата биометрической выборки. Если запись выполнена успешно, для этого параметра устанавливается нулевое значение. Для захвата отпечатков пальцев определяются следующие значения:
- WINBIO_FP_TOO_HIGH
- WINBIO_FP_TOO_LOW
- WINBIO_FP_TOO_LEFT
- WINBIO_FP_TOO_RIGHT
- WINBIO_FP_TOO_FAST
- WINBIO_FP_TOO_SLOW
- WINBIO_FP_POOR_QUALITY
- WINBIO_FP_TOO_SKEWED
- WINBIO_FP_TOO_SHORT
- WINBIO_FP_MERGE_FAILURE
-
-
Ошибка
-
Структура, идентифицирующая успешность или сбой отслеживаемой операции.
-
ErrorCode
-
Значение HRESULT, содержащее S_OK или код ошибки, полученный в результате вычислений, выполненных с помощью Windows Biometric Framework.
-
-
Комментарии
Вызовите функцию WinBioRegisterEventMonitor , чтобы зарегистрировать подпрограмму обратного вызова для получения уведомлений о событиях из Windows Biometric Framework. Обратный вызов — это пользовательская функция, которую необходимо определить для приложения.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента |
Windows 7 [только классические приложения] |
| Минимальная версия сервера |
Windows Server 2008 R2 [только классические приложения] |
| Заголовок |
|