ГОСТ Р ИСО/МЭК 19784-2—2010
Описание
Данная функция сохраняет ЗБИ. идентифицируемую параметром BIRToStore. в открытой базе
данных ЗБИ. идентифицируемой параметром UnitID. Значениеидентификатора модуля, предоставлен
ное ПБУ в качестве входного параметра данной функции, и значение идентификатора модуля, предо
ставленное инфраструктурой БиоАПИ ПБУ при вызове функции BioSPI_BSPAttach (в случае его
наличия), могутнесовпадать, еслиоба значенияидентификаторасоответствуютодномуитомуже моду
лю БиоАПИ (см. 5.2.5).
Если значение параметра BIRToStore определяется дескриптором ЗБИ. то входной дескриптор
ЗБИ освобождается. Если значение параметра BIRToStore определяется значением первичного ключа
базы данных, то ЗБИ копируется в открытую базу данных. Новой ЗБИ в базе данных присваивается
новый УУИД. который может использоваться в качествезначения первичногоключадля последующего
доступа к ЗБИ.
Параметры
UnitID (входной параметр) — идентификатор модуля архива, управляющего базой данных.
BIRToStore (входной параметр) — ЗБИ. сохраняемая в открытой базе данных (или ЗБИ, или ее
дескриптор, или указатель на ЗБИ вдругой открытой базе данных).
Uuid (выходной параметр) — УУИД. однозначно определяющий новую ЗБИ в базе данных. Дан
ный УУИД не можетбытьизменен. ЗБИ добавляется в конец базы данных.
Возвращаемое значонио
Значение BioAPI_RETURNуказываетнауспешное выполнениефункцииили определяеттипошиб
ки. Значение ВюАР1_ОК соответствует успешному выполнению функции. Остальные значения опреде
ляют типошибки.
Ошибки
BioAPIERR_INVALID_UNIT_ID
5.2.17 BioAFPI_DbGetBIR
BioAPI_RETURN BioAPI Bk>AFPI_DbGetBIR
(BioAPI_UNIT_ID UnitID.
constBioAPI_UUID ’KeyValue.
BioAPI_BIR_HANDLE ’RetrievedВIR,
BioAPI_DB_MARKER ‘Marker).
Описание
Данная функция извлекает ЗБИ, определенную параметром KeyValue. в открытой базе данных
ЗБИ. определенной параметром UnitID. Функция копирует ЗБИ в память ПБФ и возвращаетдескриптор
ЗБИ. Указатель Markerустанавливается на извлекаемую ЗБИ и может быть впоследствии использован
для повторного обращения к базе данных, начинаяс записи, следующей за извлекаемой.
Блок памяти, возвращенный с помощью функции ИПБФА. должен бытьосвобожден ПБУ.
Значение идентификатора модуля, предоставленное ПБУ в качестве входного параметра данной
функции, и значение идентификатора модуля, предоставленное инфраструктурой БиоАПИ ПБУ при
вызове функции BioSPI_BSPAttach (в случао его наличия), могут не совпадать, если оба значения иден
тификатора соответствуютодному итому же модулю БиоАПИ (см. 5.2.5).
Параметры
UnitID (входнойпараметр) — идентификатор модуля архива, управляющего базой данных.
KeyValue (входной параметр) — значение первичного ключа извлекаемой ЗБИ в базе данных
ЗБИ.
ReteivedBIR (выходнойпараметр) — дескриптор извлекаемой ЗБИ.
Marker(выходнойпараметр) — указательна запись, которыйможетбытьвпоследствии использо
ван для повторногообращения к базеданных, начиная с записи, следующей за извлекаемой.
Возвращаемое значение
Значение BioAPI_RETURNуказываетнауспешное выполнениефункцииили определяеттипошиб
ки. Значение BioAPI_OK соответствует успешному выполнению функции. Остальные значения опреде
ляют типошибки.
Ошибки
BioAPIERR_INVALID_UNIT_ID
BioAPIERR_RECORD_NOT_FOUND
12