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

     8.1.18 Функция BioAPI_EnumFrameworks (БиоАПИ 2.1)

Данный пункт применяется только при использовании БиоАПИ версии 2.1.

8.1.18.1 Описание

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

В спецификации, предоставленной в настоящем стандарте, данная функция возвращает информацию об одной инфраструктуре и, следовательно, аналогична BioAPI_GetFrameworklnfo (хотя и с разными параметрами).

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

a) выделяет область памяти, достаточную для размещения массива элементов типа BioAPI_FRAMEWORK_SCHEMA с числом элементов, равным числу видимых инфраструктур;

b) заполняет массив схемами инфраструктур для всех видимых инфраструктур; и

c) возвращает адрес массива в параметре FwSchemaArray и число элементов массива в параметре NumberOfElements.

Данная функция должна вызываться только в том случае, если был произведен хотя бы один вызов BioAPl_Init или BioAPI_InitEndpoint, для которого еще не было произведено соответствующего вызова BioAPI_Terminate.

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

Область памяти, содержащая массив, должна быть освобождена приложением с помощью вызова функции BioAPI_Free (см. 8.7.2), в том случае если она больше не используется приложением. Области памяти, указанные элементами Path и HostingEndpoint в рамках каждого элемента массива, также должны быть освобождены приложением с помощью вызова функции BioAPI_Free, в том случае, если они больше не используются приложением.     

8.1.18.2 Параметры

BFPSchemaArray (выходной) - указатель на адрес массива элементов типа BioAPI_FRAMEWORK_SCHEMA (распределенного инфраструктурой), содержащего информацию о схемах инфраструктур.

NumberOfElements (выходной) - указатель на число элементов массива (число инфраструктур, на текущий момент видимых приложению - только одна, за исключением использования стандарта межсетевого обмена).     

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

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

8.1.18.4 Ошибки

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

8.1.13-8.1.18 (Введены дополнительно, Изм. N 1).