ГОСТ Р ИСО/МЭК19784-1—2007
BioAPIERR_lNVALID_UUID
BioAPIERR_INVALID_ACCESS_REQUEST
BioAPIERR_DATABASE_!S_CORRUPT
Данные об обработке ошибок БиоАП
И
приведены в разделе 11.
8.5.2 Функция BioAPI_DbClose
BioAPI_ RETURN BioAPI BioAPI_DbClose
(BioAPI_HANDLE BSPHandle,
BioAPI_DB_HANDLE DbHandle):
8.5.2.1 Описание
Данная функция закрывает открытую базуданных ЗБИ. Все маркеры, установленные для записей в
базеданных, освобождаются и их дескрипторы становятся недействительны.
П р и м е ч а н и е — Если база данных, открытая в режиме ВюАРID В_АССЕSS_WRIТЕ не будет закрыта,
она может быть повреждена.
8.5.2 2 Параметры
BSPHandle (входной)— дескриптор присоединенного ПБУ.
DbHandle (входной) — дескриптор БД для открытой базы данных ЗБИ. управляемой ПБУ. Данный
параметр определяетоткрытую базуданных, которая должна быть закрыта.
8.5.2.3 Возвращаемое значение
Значение BioAPLRETURN указывает на успешное выполнение функции или определяет тип ошибки.
Значение ВюАР1_ОК указывает на успешное выполнение функции. Все остальные значения описывают
типошибки.
8.5.2.4 Ошибки
BioAPIERR_UNABLE_TO_CLOSE_DATABASE
BioAPIERRJNVALID_DB_HANDLE
BioAPIERR_DATABASE_IS_CORRUPT
Данные об обработке ошибок БиоАПИ приведены в разделе 11.
8.5.3 Функция BioAPI_DbCreate
BioAPI_RETURN BioAPI BioAPI_DbCreate
(BioAPLHANDLE BSPHandle?
const B»oAPI_UUID ’DbUuid,
uint32_t NumberOfRecords,
B>oAPI_DB_ACCESS_TYPE AccessRequest.
BioAPI_DB. HANDLE ’DbHandle).
8.5.3.1 Описание
Данная функция создает и открывает новую базуданных ЗБИдля присоединенного вданный момент
модуля архива установленного вызова ПБУ Идентификация новой базы данных определяется входным
параметром DbUuid. который должен быть создан биометрическим приложением и должен отличаться от
УУИД всех баз данных, какоткрытых, так и закрытых вданный момент, поддерживаемых данным модулем
архива. Вновь созданная база данных ЗБИ может быть открыта в указанном режиме доступа.
П р и м е ч а н и е — Функция используется для создания новой базы данных ЗБИ. Она не передает никакой
информации модулю архива о новой базе данных, за исключением ее УУИД и условий доступа. Существуют
архивы, которые могут работать только с базами данных статического размера или которым требуются значи
тельные усилия для управления базой данных с динамически изменяемым размером (например, смарт-карта ми,
которые сохраняют шаблоны в «прозрачных» или структурированных файлах и имеют статический размер,
зависящий от характеристик операционной системы смарт-карты). Для создания новой базы данных ЗБИ архиву
может потребоваться информация о ее размере. Так как вызывающее приложение может не знать средний или
максимальный размер шаблона (в байтах), то оно предоставляет максимальное число записей, которые будут
сохранены в базе данных. Если архив может работать с динамическими базами данных, то он будет игнорировать
параметр NumberOfRecords.
8.5.3.2 Параметры
BSPHandle (входной)— дескриптор присоединенного ПБУ.
DbUuid (входной) — указатель на УУИД. который будет идентифицировать создаваемую базу дан
ных ЗБИ.
NbrRecords (входной) — максимальное число записей, которые будут сохранены вбазе данных ЗБИ.
57