ГОСТ Р ИСО/МЭК19784-1—2007
NumberOfResults (выходной) — указатель на число кандидатов, возвращенных в параметре Candidates
в качестве результата сопоставления 1:N.
Candidates (выходной) — указатель на адрес массива элементов типа BioAPI_CANDIDATE, содержа
щий информацию о ЗБИ. идентифицированных как результат процесса сопоставления (то есть индексы,
связанные с ЗБИ,для которых был превышен порог сопоставления). Данный массив является ранжирован
ным. причем записьслучшей оценкой схожести (наиболее соответствующая) находится на первом месте.
Если ни одного кандидата не найдено, память под массив не выделяется и возвращается пустой
указатель. Если параметр Population был представлен в базе данных ЗБИ. т. е. значение
BioAPI_IDENTIFY_POPULATION_TYPE равно BioAPI_DB_TYPE. то массив содержит указатели на УУИД.
связанные с ЗБИ. хранящимися во внутренней базе данных регистрации ПБУ. Если параметр Population
был представлен как массив ЗБИ. то BioAPI_IDENTIFY_POPULATION_TYPE имеет значение
BioAPI_ARRAY_TYPE и массив Candidates содержит указатели на относительные индексы в передавае
мом массиве.
TimeOut (входной) — целое число, определяющее значение времени ожидания (в миллисекундах)
для выполнения операции. Если время ожидания истекло, функция возвращает ошибку, памятьдля масси
ва не выделяется и возвращается пустой указатель. Данное значение может быть любым положительным
числом. Значение минус 1 означает, что будет использоваться значение времени ожидания, заданное ПБУ
по умолчанию.
8.4.6.3 Возвращаемое значение
Значение BioAPI_RETURN указывает на успешное выполнение функции или определяет тип ошибки.
Значение BioAPI_OK указывает на успешное выполнение функции. Все остальные значения описывают
типошибки.
8.4.6.4 Ошибки
BioAPIERR INVALID_BIR HANDLE
BioAPIERR_BIR_SIGNATURE_FAILURE
BioAPIERR TIMEOUT_EXPIRED
BioAPIERR NO INPUT_BIRS
BioAPIERR_FUNCTION_NOT_SUPPORTED
BioAPIERR_INCONSISTENT_PURPOSE
BioAPIERR_BIR_NOT_FULLY_PROCESSED
BioAPIERR_RECORD_NOT_FOUND
BioAPIERR_QUALITY_ERROR
BioAPIERR_FUNCTION_FAILED
BioAPIERR_PRESET_BIR_DOES_NOT_EXIST
BioAPIERR_INVALID_DB_HANDLE
Данные об обработке ошибок БиоАПИ приведены в разделе 11.
Г 1 р и м е ч а н и е 1 — Не все ПБУ поддерживают идентификацию 1:N. Данное указание должно быть
приведено в руководстве по программированию конкретного ПБУ.
П р и м е ч а н и е 2 — В зависимости от ПБУ. местоположения и размера базы данных, по которой
производится поиск, выполнение данной операции может занять значительное время. Рекомендуемое значе
ние параметра Timeout должно быть указано в руководстве по программированию конкретного ПБУ.
П р и м е ч а н и е 3 — Число кандидатов сопоставления, найденных ПБУ. зависит от текущего ОЛС
алгоритма сопоставления, установленного в параметре MaxFMRRequested.
8.4.7 Функция BioAPI_Enroll
BioAPI_RETURN BioAPI BioAPI_Enroll
(BioAPI_HANDLE BSPHandle,
BioAPI_BIR_PURPOSE Purpose.
BtoAPI_BIR_SUBTYPE Subtype.
const BioAPI_BIR_BIOMETRIC_DATA_FORMAT ’OutputFormat.
const BioAPI_INPUT_BIR ‘ ReferenceTemplate.
BioAPI_BIR_HANDLE ‘NewTemplate,
const BioAPI_DATA ‘Payload.
int32_t Timeout,
BioAPI_BIR_HANDLE ‘AuditData.
BioAPI_UUID ‘TemplateUUID);
48