ГОСТ Р ИСО/МЭК19784-1—2007
8.5.8.1 Описание
Данная функция извлекает ЗБИ. идентифицированную параметром
KeyValue
воткрытой базе данных
ЗБИ. идентифицированной параметром
DbHandle.
Функция копирует ЗБИ в память ПБУ и возвращает ее
дескриптор. Маркер создается и устанавливается на запись, следующую за восстановленной ЗБИ в
базе
данных (или на первую запись базы данных, если восстановленная ЗБИ является последней), и возвраща
ется дескриптор на маркер.
Область памяти, возвращаемая при вызове функции БиоАПИ. должна быть освобождена приложе
нием путем вызова функции BioAPI_Free (8.7.2).
8.5.8.2 Параметры
BSPHandle
(входной)— дескриптор присоединенного ПБУ.
DbHandle
(входной)— дескриптор открытой базы данных ЗБИ.
KeyValue
(входной) — ключ в базе данных извлекаемой ЗБИ.
RetrievedBIR
(выходной) — дескриптор извлеченной ЗБИ.
MarkerHandle
(выходной)— дескриптор маркера, который может быть впоследствии использован при
ложением для выполнения итераций вбазе данных ЗБИ. начиная с позиции восстановленной ЗБИ.
8.5.8.3 Возвращаемое значение
Значение BioAPI_RETURN указывает на успешное выполнение функции или определяет тип ошибки.
Значение ВюАР1_ОК указывает на успешное выполнение функции. Все остальные значения описывают
типошибки.
8.5.8.4 Ошибки
BioAPIERR RECORD_NOT FOUND
BioAPIERRJNVAUD_DB_HANDLE
Данные об обработке ошибок БиоАПИ приведены в разделе 11.
8.5.9 Функция BioAPI DbGetNextBIR
BioAPI_RETURN BtoAPI BioAPI_DbGetNextBIR
(BioAPI_HANDLE BSPHandle,
BioAPI_DB_HANDLE DbHandle.
BioAPI„DB_MARKER_HANDLE MarkerHandle,
BioAPI_BIR_HANDLE ‘RetrievedBIR,
BioAPI_UUID ‘ BirUuid);
8.5.9.1 Описание
Данная функция извлекает ЗБИ, идентифицированную параметром
MarkerHandle.
Функция копирует
ЗБИ в память ПБУ и возвращает ее дескриптор, а также указатель на УУИД. который однозначно иденти
фицирует ЗБИ в базе данных, после чего маркер устанавливается на следующую запись в базе данных.
П р и м е ч а н и е — Если в базе данных больше нет записей, маркер будет указывать на несуществующую
позицию.
8.5.3.2 Параметры
BSPHandle
(входной) — дескриптор присоединенного ПБУ.
DbHandle
(входной)— дескриптор открытой базы данных ЗБИ.
MarkerHandle
(входной/выходной) — дескриптор маркера, указывающий, какая записьдолжна быть
восстановлена.
RetrievedBIR
(выходной)— дескриптор извлеченной ЗБИ.
BirUuid
(выходной) — УУИД. однозначно идентифицирующий извлеченную ЗБИ в базе данных.
8.5.9.3 Возвращаемое значение
Значение BioAPI_RETURN указывает на успешное выполнение функции или определяет тип ошибки.
Значение BioAPI_OK указывает на успешное выполнение функции. Все остальные значения описывают
тип ошибки.
8.5.9.4 Ошибки
BioAPIERR END_OF_DATABASE
BioAPIERR_MARKERHANDLE_IS INVALID
BioAPIERR_INVALID_DB_HANDLE
Данные об обработке ошибок БиоАПИ приведены в разделе 11.
8.5.10 Функция BioAPI_DbDoletoBIR
BioAPI_RETURN BioAPI BioAPI_DbDeleteBIR
(BioAPI_HANDLE BSPHandle.
BioAPI_DB_HANDLE DbHandle.
const BioAPlJJUID ‘KeyValue);
60