ГОСТ Р ИСО/МЭК19784-1—2007
Установкой указателя AdaptedBIR на непустой указатель приложение может потребовать, чтобы ЗБИ
была создана адаптацией ReferenceTemplate с использованием ProcessedBIR. Новый дескриптор возвра
щается указателем AdaptedBIR. Если сопоставление проведено успешно, то может быть сделана попытка
адаптации ReferenceTemplate с использованием информации, взятой из ProcessedBIR. Не все ПБУ поддер
живают адаптацию. Полученный AdaptedBIRдолжен считаться оптимальным шаблоном регистрации идол-
жен быть сохранен в базе данных регистрации. Решение об использовании или отказе от использования
этих данных принимает приложение. Важно отметить, что адаптация может быть проведена не во всех
случаях. При выполнении адаптации данная функция сохраняетдескриптор новой ЗБИ в памяти, на кото
рую указывает параметр AdaptedBIR.
Если ReferenceTemplate связана с Payload (полезная информация), то она может быть возвращена
при условии успешной верификации, если FMRAchieved имеет допустимое значение: данный процесс уп
равляется политикой ПБУ и должен быть указан в его схеме.
П р и м е ч а н и е 1— Не все ПБУ поддерживают возвращение полезной информации.
П р и м е ч а н и е 2 — Дополнительная информация об использовании Payload приведена в приложении А.
подпункт А.4.6.2.6, и приложении С. раздел С.5.
Область памяти, возвращаемая при вызовефункции БиоАПИ,должна бытьосвобождена приложением
сразу же после прекращения его использования функцией BioAPI_Free (см. 8.7.2). Если адаптированная
ЗБИ возвращается, ее дескриптор может быть освобожден путем вызова функции BioAPI_FreeBIRHandle.
8.4.5.2 Параметры
BSPHandle (входной)— дескриптор присоединенного ПБУ.
MaxFMRRequested (входной) — значение ОЛС, являющееся критерием успешной верификации (то
есть порогом сопоставления).
ProcessedBIR (входной) — верифицируемая ЗБИ или еедескриптор.
ReferenceTemplate (входной) — верифицирующая (контрольная) ЗБИ. ее ключ в базеданных ЗБИ или
ее дескриптор.
AdaptedBIR (выходной/необязательный)— указательна дескриптор адаптированной ЗБИ. Данный
указатель может быть пустым, если нетребуется создание адаптированно*’! ЗБИ. Не все ПБУ поддерживают
адаптацию ЗБИ. Функция может возвратить значение дескриптора
B io A P I_ U N S U P P O R T E D _ B IR _ H A N D L E ,
чтобы указать, что адаптация не поддерживается, или значение BioAPI_INVALID_BIR_HANDLE, чтобы ука
зать. что адаптация невозможна.
Result (выходной) — указатель на Булево значение (BioAPI_TRUE/BioAPI_FALSE), показывающее,
является ли результатсопоставления ЗБИ положительным или нет всоответствии с установленными крите
риями.
FMRAchieved (выходной) — указатель на значение ОЛС, означающее близость соответствия.
Payload (выходной/необязательный) — если с ReferenceTemplate связана полезная информация, то
она возвращается в выделенную впамяти структуру BioAPI_DATA втом случае,если значение FMRAchieved
соответствуетполитике ПБУ.
8.4.5.3 Возвращаемое значение
Значение BioAPI_RETURN указывает на успешное выполнение функции или определяет тип ошибки.
Значение ВюАР1_ОК указывает на успешное выполнение функции. Все остальные значения описывают
типошибки.
8.4.5.4 Ошибки
BioAPIERRJNVALID_BIR_HANDLE
BioAPIERRJNVALID_BIR
ВкхАР IE RR_BIR_SIG NATU RE_FAILU RE
b
iq
a
p
i
e
r r jn c o n s is t
e
n t
p
u r
p
o s
e
BioAPIERR_BIR_NOT_FULLY_PROCESSED
BioAPIERR_RECORD_NOT_FOUND
BtoAPIERR_QUALITY_ERROR
Данные об обработке ошибок БиоАПИ приведены в разделе 11.
8.4.6 Функция BioAPlJdentifyMatch
BioAPIJRETURN BioAPI BioAPlJdentifyMatch
(BioAPI_HANDLE BSPHandle,"
BioAPI _FMR MaxFMRRequested.
const BioAPIJNPUTJ3IR ’ProcessedBIR.
46