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

     8.1.6 Функция BioAPI_BSPUnload

8.1.6.1 Описание

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

Для однозначного определения зарегистрированных обратных вызовов инфраструктура БиоАПИ использует три входных параметра: BSPUuid, AppNotifyCallback и AppNotifyCallbackCtx.

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

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

Это же происходит и в случае, когда действия, соответствующие отсутствующему вызову функции BioAPI_BSPUnload, неявно выполнены инфраструктурой во время вызова функции BioAPI_Terminate (см. 8.1.2).

8.1.6.2 Параметры

BSPUuid (входной) - УУИД БСП, выбранного для выгрузки.

AppNotifyCallback (входной/необязательный) - функция уведомления о событии, для которой будет выполнена отмена регистрации. Функция, которая была передана при вызове функции BioAPI_BSPLoad.

AppNotifyCallbackCtx (входной/необязательный) - контекст уведомления о событии, который был предоставлен в соответствующем вызове функции BioAPI_BSPLoad.

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

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

8.1.6.4 Ошибки

BioAPIERR_INVALID_UUID

BioAPIERR_BSP_NOT_LOADED

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