ГОСТ Р ИСО/МЭК19784-1—2007
П р и м е ч а н и е — В зависимости от размера передаваемой базы данных и требуемой степени преобра
зования выполнение данной операции гложет занять значительное время.
8.5 Операции над базой данных
Операции над базой данных обеспечиваютдоступ приложения к базам данных ЗБИ архива модулей
БиоАПИ (либо непосредственно управляемыми ПБУ, либо реализованными через ПБФ).
П р и м е ч а н и е 1 — Описание контекста и использования функций базы данных приведено в
приложении С. раздел С.6.
П р и м е ч а н и е 2 — Механизмы авторизации для управления правом биометрического приложения
создавать, удалять или производить запись в базу данных в настоящем стандарте не рассматриваются (но могут
ссыпаться на ИСО/МЭК 19784-2 «Информационные технологии — Программный интерфейс биометрического
приложения — Часть 2: Интерфейс поставщика функции биометрического архива»).
8.5.1 Функция BioAPI_DbOpen
BioAPI_RETURN BioAPI BioAPI_DbOpen
(BioAPI_HANDLE
BSPHandle7
const BioAPMJUID *DbUuid.
BioAPI_DB_ACCESS_TYPE AccessRequest.
BioAPI_DB_HANDLE ‘DbHandle.
BioAPI_DB_MARKER_HANDLE ’MarkerHandlo);
8.5.1.1 Описание
Данная функция открывает базу данных ЗБИ. поддерживаемую текущим присоединенным архивом
установленного вызова ПБУ. используя режим доступа, указанный в AccessRequest. Создается новый
маркер и устанавливается на первую запись в базе данных ЗБИ. а затем возвращается дескриптор данно го
маркера.
Некоторые ПБУ могут поддерживать только отдельную базуданных ЗБИ или иметь предпочтитель
ную базуданных. Приложение может предоставить ПБУ возможность выбрать базуданных ЗБИ для откры
тия. используя значение пустогоуказателя для параметра УУИД базы данных.
П р и м е ч а н и е — Каждый вызов данной функции должен сопровождаться вызовом функции
BioAPI_DbFreeMarker для освобождения ресурсов маркера. В приложении должно быть учтено, что каждый
вызов функции BioAP!_DbOpen приводит к выделению ресурсов, которые не могут быть автоматически освобож
дены. в противном случав будет невозможно выполнять итерации в базе данных с использованием возвращенно
го дескриптора маркера. Если приложение не требует выполнения итераций в базе данных, то оно должно сразу
же вызвать функцию BioAPI _DbFreeMarker, в противном случае оно должно выполнить это после завершения
итерации.
8.5.1.2 Параметры
BSPHandle
(входной) — дескриптор присоединенного вызова ПБУ.
DbUuid (входной) — указатель на УУИД. определяющий открываемую базу данных ЗБИ. Если указа
тель пустой, то ПБУ должен выбрать базуданных ЗБИ.
AccessRequest (входной) — признак требуемого режима доступа к базе данных ЗБИ
BioAPI_DB_ACCESS_READ или BioAPI_DB_ACCESS_WRITE. В отдельной системе в каждый момент
времени только одно приложение может открыть адресуемую базу данных в режиме записи
BioAPI_DB_ACCESS_WRITE.
DbHandle
(выходной)— дескриптор открытой базы данных ЗБИ. Если выполнение функции оканчива
ется ошибкой, данное значение будет установлено в BioAPI_DB_INVAUD_HANDLE.
Marker (выходной)— дескриптор признака, который впоследствии может использоваться прило
жением для выполнения итераций в базе данных ЗБИ. начиная с первой записи.
8.5.1.3 Возвращаемое значение
Значение BioAPI_RETURN указывает на успешное выполнение функции или определяет тип ошибки.
Значение BioAPI_OK указывает на успешное выполнение функции. Все остальные значения описывают
тип ошибки.
8.5.1.4 Ошибки
BioAPIERR_UNABLE_TO_OPEN_DATABASE
BtoAPIERR_DATABASE_IS_OPEN
BioAPIERR_DATABASE_IS_LOCKED
BioAPIERR_DATABASE„DOES_NOT_EXIST
56