ГОСТ Р ИСО/МЭК 19784-2—2010
5.2.14 BioAFPI_DbSotMarker
BioAPI_RETURN BioAPI BioAFPI_DbSetMarker
(BioAPI_UNIT_ID UnitID,
const BioAPIUUID ‘KeyValue,
BioAPI_DB_MARKER ‘Marker).
Описанио
С помощью данной функции указателю Marker присваивается значение для указания на запись,
обозначенную параметром KeyValue в базе данных ЗБИ, идентифицируемой с помощью параметра
UnitID. Если параметр KeyValue имеет NULL-значение, указатель устанавливается на первую запись в
базеданных ЗБИ.
П р и м е ч а н и е — При возникновении ошибки положение указателя не изменяется.
Значение идентификатора модуля, предоставленное ПБУ в качестве входного параметра данной
функции, и значение идентификатора модуля, предоставленное инфраструктурой БиоАПИ ПБУ при
вызове функции BioSPI_BSPAttach (вслучаеего наличия), могут не совпадать, если оба значения иден
тификатора соответствуют одномуи тому же модулю БиоАПИ (см. 5.2.5).
Параметры
UnitID (входнойпараметр) — идентификатор модуля архива, управляющего базой данных.
KeyValue (входной параметр) — значение первичного ключа записи в базе данных ЗБИ, на кото
руюдолжен указывать Marker.
Marker(входной/выходной параметр) — указатель, который используется для повторного обра
щения кбазеданных, начиная с позиции извлекаемой записи.
Возвращаемое значение
Значение BioAPI_RETURN указываетнауспешноевыполнениефункцииили определяеттипошиб
ки. Значение BioAPI_OK соответствуетуспешному выполнению функции. Остальные значения опреде
ляюттип ошибки.
Ошибки
BioAPIERR_RECORD_NOT_FOUND
BioAPIERR_INVALID_UNIT_ID
5.2.15 BioAFPI_DbFreeMarker
BioAPI_RETURN BioAPI BioAFPI_DbFreeMarker
(BioAPI_UNIT_ID UnitID,
BioAPI_DB_MARKER ‘Marker).
Описание
Данная функция освобождает память иресурсы, связанные сопределенным указателем Marker.
Значение идентификатора модуля, предоставленное ПБУ в качестве входного параметра данной
функции, и значение идентификатора модуля, предоставленное инфраструктурой БиоАПИ ПБУ при
вызове функции BioSPI_BSPAttach (вслучаеего наличия), могут не совпадать, если оба значения иден
тификаторасоответствуют одномуи томуже модулю БиоАПИ (см. 5.2.5).
Параметры
UnitID (входнойпараметр) — идентификатор модуля архива, управляющего базой данных.
Marker(входнойпараметр) — указатель базы данных ЗБИ. которыйдолжен бытьосвобожден.
Возвращаемоо значение
ЗначениеBioAPI_RETURN указываетнауспешноевыполнениефункцииили определяеттипошиб
ки. Значение BioAPI_OK соответствуетуспешному выполнению функции. Остальные значения опреде
ляюттип ошибки.
Ошибки
BioAPIERR_MARKER_IS INVALID
BioAPIERRJNVALIDJJNlTJD
5.2.16 BioAFPI_DbStoreBIR
BioAPI_RETURN BioAPI BioAFPI_DbStoreBIR
(BioAPI_UNIT_ID UnitID.
const BioAPI_INPUT_BIR ‘BIRToStore,
BioAPI_UUID *Uuid).
11