Функция WbioQueryEngineInterface (winbio_adapter.h)

Статья
08/27/2023

Извлекает указатель на структуру WINBIO_ENGINE_INTERFACE для адаптера подсистемы.

Синтаксис

HRESULT WbioQueryEngineInterface(
  [out] PWINBIO_ENGINE_INTERFACE *EngineInterface
);

Параметры

[out] EngineInterface

Адрес переменной, получающей указатель на структуру WINBIO_ENGINE_INTERFACE .

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

Если функция выполняется успешно, она возвращает S_OK. Если функция завершается сбоем, она должна вернуть одно из следующих значений HRESULT , чтобы указать на ошибку.

Код возврата	Описание
E_POINTER	Параметр EngineInterface не может иметь значение NULL.

Windows Biometric Framework вызывает эту функцию после загрузки библиотеки DLL адаптера подсистемы в память. Поэтому каждая библиотека DLL адаптера подсистемы должна реализовывать и экспортировать функцию WbioQueryEngineInterface . Имя функции учитывает регистр, а его написание и сигнатура должны в точности совпадать с указанными в разделе Синтаксис.

Чтобы быть видимым для Windows Biometric Framework, функция WbioQueryEngineInterface должна быть названа в разделе EXPORTS файла команды компоновщика определения экспорта для библиотеки DLL.

Примеры

В следующем псевдокоде показана одна из возможных реализаций этой функции.

HRESULT
WINAPI
WbioQueryEngineInterface(
    __out PWINBIO_ENGINE_INTERFACE *EngineInterface)
{
    // g_EngineInterface is a global variable.
    *EngineInterface = &g_EngineInterface;
    return S_OK;
}

Требования


Минимальная версия клиента	Windows 7 [только классические приложения]
Минимальная версия сервера	Windows Server 2008 R2 [только классические приложения]
Целевая платформа	Windows
Header	winbio_adapter.h (включая Winbio_adapter.h)

См. также раздел

Функции подключаемых модулей

Поделиться через