ГОСТ Р ИСО/МЭК 19784-2—2010
5.2.10 BioAFPI_DbOpen
BioAPI_RETURN BioAPI BioAFPI_DbOpen
(BioAPI_UNIT_ID UnitID,
BioAPI_DB_ACCESS_TYPEAccessRequest,
BioAPI_DB_MARKER ‘ Marker).
Описание
Данная функция открывает базу данных ЗБИ. поддерживаемую подключенным в настоящее
время архивом вызванного модуля БиоАПИ. использованием режима доступа, определяемого пара
метром AccessRoquest. Указатель Marker базы данных устанавливается на первую запись в базе
данных ЗБИ.
П р и м е ч а н и е — Каждый вызов данной функции должен сопровождаться вызовом функции
BioAFPI_DbFreaMarker
для освобождения ресурсов, выделенных в функции открытия базы данных. В ПБУ должно
быть учтено, что каждый вызов функции
BloAFPI_DbOpen
приводит к выделению ресурсов, которые не могут быть
автоматически освобождены (в противном случае станет невозможным повторное обращение к базе данных с ис
пользованием возвращенного дескриптора). Если в ПБУ не планируется повторное обращение кбазе данных, сле
дует немедленновызвать функцию
BtoAFPI_DbFreeMarker.
впротивном случае вызовданной функции должен быть
выполнен после завершения повторного обращения кбазеданных.
Параметры
UnitID (входной параметр) — идентификатор модуля БиоАПИ. предварительно определенный
ПБФА.
AccessRequest (входной параметр) — признак требуемого режима доступа к базе данных, воз
можные значения признака read и write. В отдельной системе в каждый момент времени только одно
приложение может открыть адресуемую базуданных в режиме BioAPI_DB_ACCESS_WRITE. Выполне
ние данного требования контролируется ПБУ.
Marker (выходной параметр) — указатель, который используется для повторного обращения к
базе данных.
Возвращаемое значение
ЗначениеBioAPI_RETURN указываетнауспешноевыполнениефункцииили определяеттипошиб
ки. Значение BioAPI_OK соответствует успешному выполнению функции. Остальные значения опреде
ляюттип ошибки.
Ошибки
BioAPIERRJNVALIDJJNITJD
BioAPIERR_UNABLE_TO_OPEN_DATABASE
BioAPIERR_DATABASE_IS_LOCKED
BioAPIERR_DATABASE_DOES_NOT_EXIST
BioAPIERRJNVALID_ACCESS_REQUEST
BioAPIERR_DATABASE_IS_CORRUPT
5.2.11 BioAFPI_DbClose
BioAPI_RETURN BioAPI BioAFPI_DbClose
(BioAPI JJNITJD UnitID).
Описание
Данная функция закрывает базу данных ЗБИ. поддерживаемую вызовом идентифицируемого
модуля БиоАПИ. Все указатели, установленные на записи в базеданных, освобождаются.
П р и м е ч а н и е — Если база данных, открытая в режиме DB_ACCESS_WRITE, не будет закрыта, она мо
жет быть повреждена.
Значение идентификатора модуля, предоставленное ПБУ в качестве входного параметра данной
функции, и значение идентификатора модуля, предоставленное инфраструктурой БиоАПИ ПБУ при
вызове функции BioSPI_BSPAttach (вслучаеего наличия), могут не совпадать, если оба значения иден
тификаторасоответствуют одномуитомуже модулю БиоАПИ (см. 5.2.5).
Параметры
UnitID (входной параметр) — идентификатор модуля БиоАПИ. предварительно определенный
ПБФА.
9