ГОСТ Р ИСО/МЭК 19784-2—2010
5.2.18 BioAFPI_DbGetNextBIR
BioAPI_RETURN BioAPI BioAFPI_DbGetNextBIR
(BioAPlJJNIT ID UnitID,
BioAPI_DB_MARKER ‘Marker,
BioAPI_BIR_HANDLE ‘RetrievedBIR.
BioAPI_UUID *Uuid).
Описание
Данная функция извлекает ЗБИ, определенную параметром Marker. Функция копирует ЗБИ в
память ПБФ и возвращает еедескриптор, а также указатель на УУИД. который однозначноопределяет
ЗБИ в базеданных, после чего указатель Магкегустанавливается на следующую запись в базеданных.
П р и м е ч а н и е — Если в базе данных больше нет записей, указатель устанавливается на недействитель
ное местоположение.
Значение идентификатора модуля, предоставленное ПБУ в качестве входного параметра данной
функции, и значение идентификатора модуля, предоставленное инфраструктурой БиоАПИ ПБУ при
вызове функции BioSPI_BSPAttach (вслучаеего наличия), могут не совпадать, еслиоба значения иден
тификатора соответствуютодному итому же модулю БиоАПИ (см. 5.2.5).
Параметры
UnitID (входнойпараметр) — идентификатор модуля архива, управляющего базой данных.
Marker(входной/выходной параметр) — указатель на извлекаемую запись.
RetreivedBIR (выходнойпараметр) — дескриптор извлекаемой ЗБИ.
Uuid (выходной параметр) — УУИД. однозначно определяющий извлекаемую ЗБИ в базоданных
ЗБИ.
Возвращаемое значение
ЗначениеBioAPI_RETURN указываетна успешноевыполнениефункцииили определяеттипошиб
ки. Значение BioAPI_OK соответствует успешному выполнению функции. Остальные значения опреде
ляюттип ошибки.
Ошибки
BioAPIERR_INVALID_UNIT_ID
BioAPIERR_END_OF_DATABASE
BioAPIERR_MARKERJS_INVALID
5.2.19 BioAFPI_DbDeleteBIR
BioAPI_RETURN BioAPI BioAFPI_DbDeleteBIR
(BioAPI JJNITJD UnitID.
const BioAPIUUID ‘KeyValue).
Описание
Данная функция удаляет ЗБИ. определенную параметром KeyValue. в открытой базеданных ЗБИ.
определенной параметром UnitID. Если на удаляемую ЗБИ установлен указатель, то:
a) если удаляемая ЗБИ не является последней ЗБИ в базеданных, указательустанавливается на
следующую ЗБИ;
b
) в противномслучае указательустанавливается на недействительноеместоположение. Однако
дескриптор указателя остается действительным и может быть использован в последующем вызове
функции BioAFPI_DBSetMarkerдля установки указателя надругую запись.
Значение идентификатора модуля, предоставленное ПБУ в качестве входного параметра данной
функции, и значение идентификатора модуля, предоставленное инфраструктурой БиоАПИ ПБУ при
вызове функции BioSPI_BSPAttach (вслучаеего наличия), могут не совпадать, если оба значения иден
тификаторасоответствуют одномуи томуже модулю БиоАПИ (см. 5.2.5).
Параметры
UnitID (входнойпараметр) — идентификатор модуля архива, управляющего базой данных.
KeyValue (входнойпараметр) — УУИД удаляемой ЗБИ.
Возвращаемое значение
ЗначениеBioAPI_RETURN указываетнауспешноевыполнениефункцииили определяеттипошиб
ки. Значение BioAPI_OK соответствуетуспешному выполнению функции. Остальные значения опреде
ляюттип ошибки.
Ошибки
BioAPIERR_INVALID_UNIT_ID
BioAPIERR_RECORD_NOT_FOUND
13