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

     8.1.4 Функция BioAPI_EnumBSPs

8.1.4.1 Описание

Данная функция предоставляет информацию о всех ПБУ, установленных в реестре компонентов. Функция выполняет действия в следующем порядке:

a) выделяет блок памяти, достаточный для хранения массива элементов типа BioAPI_BSP_SCHEMA с числом элементов, равным числу установленных ПБУ;

b) заполняет массив схемами установленных ПБУ;

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

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

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

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

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

8.1.4.2 Параметры

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

NumElementsReturned (выходной) - указатель на число элементов массива (равно числу схем ПБУ в реестре компонентов).

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

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

8.1.4.4 Ошибки

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