WbioQueryEngineInterface 函数 (winbio_adapter.h)

检索指向引擎适配器 WINBIO_ENGINE_INTERFACE 结构的指针。

语法

HRESULT WbioQueryEngineInterface(
  [out] PWINBIO_ENGINE_INTERFACE *EngineInterface
);

参数

[out] EngineInterface

接收指向 WINBIO_ENGINE_INTERFACE 结构的指针的变量的地址。

返回值

如果函数成功,则返回S_OK。 如果函数失败,它必须返回以下 HRESULT 值之一来指示错误。

返回代码 说明
E_POINTER
EngineInterface 参数不能为 NULL

注解

Windows 生物识别框架在将引擎适配器 DLL 加载到内存中后调用此函数。 因此,每个引擎适配器 DLL 都必须实现并导出 WbioQueryEngineInterface 函数。 函数名称区分大小写,其拼写和签名必须与语法部分中提供的完全匹配。

若要对 Windows 生物识别框架可见,必须在 DLL 的导出定义链接器命令文件的 EXPORT 节中命名 WbioQueryEngineInterface 函数。

示例

以下伪代码演示了此函数的一种可能实现。

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
标头 winbio_adapter.h (包括 Winbio_adapter.h)

另请参阅

插件函数