ГОСТ Р ИСО/МЭК19784-1—2007
любым положительным числом. Значение минус 1означает, что будет использоваться значение времени
ожидания, заданное ПБУ по умолчанию.
AuditData (выходной/необязательный) — дескриптор ЗБИ. содержащей исходные биометрические
данные. Эти данные могут использоваться для предоставления личных биометрических данных.
Нулевой указатель на входе указывает, что контрольные данные недолжны быть собраны. Не все ПБУ
поддерживаютсборконтрольныхданных. ПБУ можетвозвратить значение дескриптора
BioAPI UNSUPPORTED_BIR_HANDLE. чтобы указать, что AuditData не поддерживается, или значение
BioAPUNVALID_BIR_HANDLE. чтобы указать, что контрольные данные недоступны.
8.4.9.3 Возвращаемое значение
Значение BioAPI_RETURN указывает на успешное выполнение функции или определяет тип ошибки.
Значение ВюАР1_ОК указывает на успешное выполнение функции. Все остальные значения описывают
типошибки.
8.4.3.4 Ошибки
BioAPIERR USER_CANCELLED
BioAPIERR_UNABLE_TO_CAPTURE
BioAPIERR_TOO_MANY_HANDLES
BioAPIERR_BIR SIGNATURE_FAILURE
BioAPIERR_TIMEOUT_EXPIRED
BioAPIERR_NO_INPUT BIRS
BioAPIERR„FUNCTION_NOT_SUPPORTED
BioAPIERR_INCONSISTENT_PURPOSE
BioAPIERR_RECORD_NOT_FOUND
BioAPIERR_QUAL(TY_ERROR
BioAPIERR_UNITJN_USE
BioAPIERR_PRESET_BIR_DOES_NOT_EXIST
BioAPIERRJNVALID_DB_HANDLE
Данные об обработке ошибок БиоАПИ приведены вразделе 11.
П р и м е ч а н и е 1 — Не все ПБУ поддерживают идентификацию! :N. Даннов указание должно быть
приведено в руководстве по программированию конкретного ПБУ.
П р и м е ч а н и е 2 — В зависимости от ПБУ, местоположения и размера базы данных, по которой
производится поиск, выполнение данной операции может занять значительное время. Рекомендуемое значе
ние параметра Timeout должно быть указано в руководстве по программированию конкретного ПБУ.
П р и м е ч а н и е 3 — Число кандидатов сопоставления, найденных ПБУ. зависит от текущего значения
ОЛД алгоритма сопоставления, которое указано в параметре установок порога MaxFMRRequested.
8.4.10 Функция BioAPIJmport
BioAPI_RETURN BioAPI BioAPIJmport
(BioAPI_HANDLE BSPHandle7
const BioAPI_DATA ‘InputData.
const BioAPLBIR_BIOMETRIC_DATA_FORMAT ‘ InputFormat.
const BioAPI_BIR_BIOMETRIC_DATA_FORMAT ‘OutputFormat.
B
k
>API_BIR_PURPOSE Purpose.
BioAPI_BIR_HANDLE ‘ConstructedBIR):
8.4.10.1 Описание
Данная функция передает исходные биометрические данные, полученные биометрическим при
ложением любым способом, и запрашивает указанный вызов ПБУ о необходимости создания ЗБИ опре
деленного назначения. Параметр InputData определяет буфер памяти, содержащий исходные биомет
рические данные, a InputFormat определяет формат исходных биометрических данных. Форматы
InputFormats. которые может принять конкретный ПБУ. определяются самим ПБУ (см. ошибку
BioAPIERR_UNSUPPORTED_FORMAT). Функция возвращаетдескриптор к ConstructedBIR. Если приложе
нию необходимо получить ЗБИ для их сохранения в базе данных или пересылки на сервер, оно может
извлечь их путем вызова функции BioAPI_GetBIRFromHandle или сохранить путем вызова функции
BioAPI_DbStoreBIR.
Выходные ConstmctedBIR могутбытьвосстановлены путем вызова функции BioAPI_GetBIRFromHandle,
которая освобождает дескриптор, или дескриптор может быть освобожден без восстановления ЗБИ путем
вызова функции BioAPI_FreeBIRHandle.
54