ГОСТ Р ИСО/МЭК19784-1—2007
const BioAPI_INPUT_BIR *ReferenceTemplate.
const BioAPI_BIR_BIOMETRIC_DATA_FORMAT ‘OutputFormat.
BioAPI_BIR_HANDLE ‘NewTemplate.
const BioAPI_DATA ‘Payload,
BioAPI_UUID ‘TemplateUUID);
8.4.2.1 Описание
Данная функция принимает ЗБИ. содержащую биометрическиеданные в промежуточной форме, для
создания нового шаблона регистрации. Новая ЗБИ создается с помощью CapturedBIR. Также функция
можетдополнительно выполнить адаптацию на основе существующего ReferenceTemplate (контрольного
шаблона). Старый ReferenceTemplate остается неизменным.
Дополнительный входной ReferenceTemplate предоставляется для использования при создании
NewTemplate (нового шаблона), если ПБУ поддерживает эту возможность. Использование ПБУ входного
ReferenceTemplate для создания выходного NewTemplate необязательно.
Если ПБУ поддерживает внутреннюю или управляемую ПБУ базу данных ЗБИ (например, смарт-
карту или механизм идентификации), то он может дополнительно возвратить УУИД. присвоенный вновь
созданному ReferenceTemplate. сохраненному в управляемой ПБУ базе данных ЗБИ. Значение УУИД
должно быть таким же, как и значение, включенное в заголовок ЗБИ. если оно там присутствует.
Дескриптор ЗБИ, возвращаемый приложением, должен быть освобожден приложением
BioAPI_GetBIRFromHandle. если он больше не использует его. ЗБИ может быть восстановлена путем вызо ва
функции BioAPI_GetBIRFromHandle, которая освобождаетдескриптор.
8.4.2.2 Параметры
BSPHandle (входной) — дескриптор присоединенного ПБУ.
CapturedBIR (входной)— полученная ЗБИ или ее дескриптор.
ReferenceTemplate (входной/необязательный)— необязательно существующий шаблон, которыйдол
жен быть адаптирован, или его ключ в базе данных ЗБИ, или его дескриптор.
OutputFormat (входной/необязательный) — определяет, какой формат ББД будет использоваться при
возвращении NewTemplate. если ПБУ поддерживает более одногоформата. Пустой указатель означает, что
формат должен быть выбран ПБУ.
NewTemplate (выходной) — дескриптор вновь созданного шаблона, который получен из параметра
CapturedBIR с использованием (необязательно) ReferenceTemplate.
Payload (входной/необязательный) — указатель на данные, которые будут сохранены ПБУ. Данный
параметр игнорируется, если указатель пустой.
П р и м е ч а н и е ! — Не все ПБУ поддерживают сохранение полезной информации.
П р и м е ч а н и е 2 — Дополнительно о полезной информации указано в приложении А, подпункт А.4.6.2.6.
и приложении С. раздел С.5.
TemplateUUID (выходной/необяэательный) — указатель на 16-байтовую область памяти, в которую
дополнительно может быть возвращен присвоенный ПБУ УУИД. связанный с ReferenceTemplate (сохра
ненным в управляемой ПБУ базеданных ЗБИ). Если не требуется возвращения УУИД, указательдолжен
быть пустым.
8.4.2.3 Возвращаемое значение
Значение BioAPI_RETURN указывает на успешное выполнение функции или определяет тип ошибки.
Значение BioAPI_OK указывает на отсутствие ошибки. Все остальные значения описывают тип ошибки.
8.4.2.4 Ошибки
BioAPIERRJNVALID_BIR_HANDLE
Bk>APIERR_INVALID_BIR
BioAPIERR_BIR_SIGNATURE_FAILURE
BioAPIERR_TOO_MANY_HANDLES
BioAPIERR_UNABLE_TO_STORE_PAYLOAD
BioAPIERRJNCONSISTENT.PURPOSE
BioAPIERR_PURPOSE_NOT_SUPPORTED
BioAPIERR_UNSUPPORTED_FORMAT
BwAPIERR_RECORD_NOT_FOUND
BioAPIERR_OUALITY_ERROR
Данные об обработке ошибок БиоАПИ приведены в разделе 11.
Т - ТОБЗ
43