ГОСТ Р ИСО/МЭК19784-1—2007
AccessRequest (входной) — признак требуемого режима доступа к базе данных ЗБИ: «чтение» или
«запись». В конкретной системе в каждый момент времени толькоодно приложение может открыть адресу
емую базу данных в режиме записи BioAPI_DB_ACCESS_WR!TE.
DbHandle (выходной) — дескриптор вновь созданной и открытой базы данных. Если выполнение
функции оканчивается ошибкой, данное значениебудет установлено в ВюАРИЭВJNVALID_HANDLE.
8.5.3.3 Возвращаемое значение
Значение BioAPI_RETURN указывает на успешное выполнение функции или определяет тип ошибки.
Значение BioAPI_OK указывает на успешное выполнение функции. Все остальные значения описывают
типошибки.
8.5.3.4 Ошибки
BioAPIERR_UNABLE_TO_CREATE_DATABASE
BioAPIERR_DATABASE_ALREADY EXISTS
ВioAPIERR INVALID UUID
BkxAPIERR_INVALID_ACCESS_REQUEST
Данные об обработке ошибок БиоАПИ приведены в разделе 11.
8.5.4 Функция BioAPI_DbDeloto
BioAPI_RETURN BtoAPI BtoAPI_DbDeleto
(BioAPI_HANDLE BSPHandle.
const BtoAPIJJUID ‘ DbUuid).
8.5.4.1 Описание
Данная функция удаляет все записи из указанной базы данных ЗБИ, а также всю информацию о
состоянии, связанную с этой базой данных.
8.5.4.2 Параметры
BSPHandle (входной)— дескриптор присоединенного ПБУ.
DbUuid (входной) — указатель на УУИД. идентифицирующий удаляемую базуданных ЗБИ.
8.5.4.3 Возвращаемое значение
Значение BioAPI_RETURN указывает на успешное выполнение функции или определяет тип ошибки.
Значение BioAPI_OK указывает на успешное выполнение функции. Все остальные значения описывают
типошибки.
8.5.4.4 Ошибки
BioAPIERR_DATABASEJS_OPEN
BioAPIERR_INVALID_UUID
Данные об обработке ошибок БиоАПИ приведены в разделе 11.
8.5.5Функция BioAPI_DbSetMarker
BioAPI_RETURN BioAPI BioAPI_DbSetMarker
(BioAPI_HANDLE BSPHandle.
BioAPI_DB_HANDLE DbHandle,
const BioAPI_UUID ‘KeyValue,
BioAPI_DB_MARKER_HANDLEMarkerHandle);
8.5.5.1 Описание
Данная функция устанавливает маркер, идентифицированный параметром MarkerHandle. для указа
ния на запись, обозначенную параметром KeyValue в базе данных ЗБИ, указанной в DbHandle. Пустой
указатель приведет к установке маркера на первую запись в базе данных.
П р и м е ч а н и е — При возникновении ошибки положение маркера не изменяется.
8.5.5.2 Параметры
BSPHandle (входной)— дескриптор присоединенного ПБУ.
DbHandle (входной) — дескриптор открытой базы данных ЗБИ присоединенного архива модулей
БиоАПИ.
KeyValue (входной) — ключ в базе данных ЗБИ, на который должен быть установлен маркер.
MarkerHanle (входной/выходной) — дескриптор маркера, который должен быть установлен и может
быть впоследствии использован приложением для выполнения итераций в базе данных ЗБИ начиная с
новой позиции.
8.5.5.3 Возвращаемое значение
Значение BioAPI_RETURN указывает на успешное выполнение функции или определяет тип ошибки.
Значение BioAPI_OK указывает на успешное выполнение функции. Все остальные значения описывают
типошибки.
58