ГОСТ Р ИСО/МЭК 19784-1-2007 Автоматическая идентификация. Идентификация биометрическая. Биометрический программный интерфейс. Часть 1. Спецификация биометрического программного интерфейса (с Изменением N 1)

     8.1.1 Функция BioAPI_Init

8.1.1.1 Описание

Данная функция инициализирует инфраструктуру БиоАПИ и проверяет, совместима ли версия инфраструктуры БиоАПИ, ожидаемой приложением, с версией инфраструктуры БиоАПИ в системе. Данная функция должна быть вызвана приложением, по крайней мере, один раз.

Любой вызов функции BioAPI_Init, если предыдущий вызов функции BioAPI_Init или BioAPI_InitEndpoint (только в БиоАПИ 2.1) не был закончен соответствующим вызовом функции BioAPI_Terminate, будет обработан следующим образом: инфраструктура БиоАПИ выдаст ответ BioAPI_OK (только в том случае, если номер версии инфраструктуры совместим с номером версии, который был предоставлен предыдущим вызовом функции BioAPI_Init или BioAPI_InitEndpoint) или BioAPI_ERR_INCOMPATIBLE_VERSION, но не будет инициализирована повторно. Счетчик числа удачных вызовов BioAPI_Init или BioAPI_InitEndpoint будет сохраняться инфраструктурой и не завершится до тех пор, пока число соответствующих вызовов BioAPI_Terminate не достигнет определенного значения.

Данная функция обрабатывается в инфраструктуре БиоАПИ и не передается ПБУ.

(Измененная редакция, Изм. N 1).

8.1.1.2 Параметры

Version (входной) - номер редакции и номер поправки спецификации БиоАПИ, с которой совместимо биометрическое приложение.

8.1.1.3 Возвращаемое значение

Значение BioAPI_RETURN указывает на успешное выполнение функции или определяет тип ошибки в противном случае. Значение BioAPI_OK указывает на отсутствие ошибки и успешное выполнение функции. Все остальные значения описывают тип ошибки.

8.1.1.4 Ошибки

BioAPIERR_INCOMPATIBLE_VERSION

Данные об обработке ошибок БиоАПИ приведены в разделе 11.