ГОСТ Р ИСО/МЭК 19784-1-2007 Автоматическая идентификация. Идентификация биометрическая. Биометрический программный интерфейс. Часть 1. Спецификация биометрического программного интерфейса (с Изменением N 1)
8.1.10 Функция BioAPI_EnumBFPs
BioAPI_RETURN BioAPI BioAPI_EnumBFPs | ||||
(BioAPI_BFP_SCHEMA **BFPSchemaArray, | ||||
uint32_t *NumberOfElements); | ||||
8.1.10.1 Описание
Данная функция предоставляет информацию обо всех ПБУ, установленных в данное время в реестре компонентов, и выполняется в следующем порядке:
a) выделяет область памяти, достаточную для размещения массива элементов типа BioAPI_BFP_SCHEMA с числом элементов, равным числу установленных ПБУ;
b) заполняет массив схемами всех установленных ПБУ;
c) возвращает адрес массива в параметре BSPSchemaArray и размер массива в параметре NumberOfElements.
Данная функция может быть вызвана только в том случае, если был сделан, по крайней мере, один вызов функции BioAPI_Init или BioAPI_InitEndpoint (только в БиоАПИ 2.1), для которого еще не был сделан соответствующий вызов функции BioAPI_Terminate.
Данная функция обрабатывается в инфраструктуре БиоАПИ и не передается ни одному ПБУ.
Область памяти, содержащая массив, должна быть освобождена приложением с помощью вызова функции BioAPI_Free (см. 8.7.2) в том случае, если он больше не нужен приложению.
Область памяти, на которую указывают параметры Path и BFPProperty в пределах каждого элемента массива, также должна быть освобождена приложением путем вызова функции BioAPI_Free, если элементы массива не используются приложением.
(Измененная редакция, Изм. N 1).
8.1.10.2 Параметры
BfpSchemaArray (выходной) - указатель на массив элементов типа BioAPI_UNIT_SCHEMA (распределенный инфраструктурой), содержащих информацию о схемах ПБУ.
NumberOfElements (выходной) - указатель на число элементов массива, равное числу схем ПБУ в реестре компонентов.
8.1.10.3 Возвращаемое значение
Значение BioAPI_RETURN указывает на успешное выполнение функции или определяет тип ошибки. Значение BioAPI_OK указывает на отсутствие ошибки. Все остальные значения описывают тип ошибки.
8.1.10.4 Ошибки
Данные об обработке ошибок БиоАПИ приведены в разделе 11.