Статус документа
Статус документа

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

     

     8.1.2 Функция BioAPI_Terminate


BioAPI_RETURN BioAPI BioAPI_Terminate (void);

8.1.2.1 Описание

Данная функция завершает использование инфраструктуры БиоАПИ. Инфраструктура может произвести очистку внутреннего состояния, связанного с запрашивающим приложением.

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

Данная функция не должна вызываться приложением, если был сделан вызов функции BioAPI_BSPLoad, для которого не был выполнен соответствующий вызов функции BioAPI_BSPUnload (для данного УУИД ПБУ). Если данная функция должна быть вызвана во время существования загруженных ПБУ, то для каждого вызова функций BioAPI_BSPLoad, для которого не был выполнен вызов функции BioAPI_BSPUnload, инфраструктура БиоАПИ должна неявно выполнить действия, соответствующие отсутствующему вызову BioAPI_BSPUnload (как если бы соответствующая функция была вызвана), а затем выполнить действия, соответствующие BioAPI_Terminate (т.е. инфраструктура должна выгрузить все ПБУ до завершения использования инфраструктуры).

Данная функция обрабатывается в инфраструктуре БиоАПИ и не передается ПБУ, за исключением тех случаев, когда подразумевается выполнение функции BioAPI_BSPUnload, как указано выше.

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

8.1.2.2 Параметры

Отсутствуют.

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

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

Примечание - Обычно ожидается успешное выполнение функции BioAPI_Terminate; однако при возникновении непредвиденных условий приложение может не предпринимать дальнейшие действия.

8.1.2.4 Ошибки

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