PIBIO_ENGINE_QUERY_EXTENDED_ENROLLMENT_STATUS_FN回调函数 (winbio_adapter.h)

  • 项目

由 Windows 生物识别框架在客户端应用程序查询 WINBIO_PROPERTY_EXTENDED_ENROLLMENT_STATUS 属性时调用。

语法

PIBIO_ENGINE_QUERY_EXTENDED_ENROLLMENT_STATUS_FN PibioEngineQueryExtendedEnrollmentStatusFn;

HRESULT PibioEngineQueryExtendedEnrollmentStatusFn(
  [in, out] PWINBIO_PIPELINE Pipeline,
  [out]     PWINBIO_EXTENDED_ENROLLMENT_STATUS EnrollmentStatus,
  [in]      SIZE_T EnrollmentStatusSize
)
{...}

参数

[in, out] Pipeline

指向与执行操作的生物识别单元关联的 WINBIO_PIPELINE 结构的指针。

[out] EnrollmentStatus

指向包含此函数返回的扩展注册状态信息的 WINBIO_EXTENDED_ENROLLMENT_STATUS 结构的指针。

[in] EnrollmentStatusSize

扩展注册状态信息的指定大小（以字节为单位）。

返回值

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

返回代码 说明
E_POINTER
 Pipeline 参数不能为 NULL。
E_INVALIDARG
EnrollmentStatusSize 参数指示输出缓冲区太小。

注解

每次调用 WinBioEnrollCapture 函数后，注册应用程序都可以请求扩展注册状态信息。

如果调用此例程时生物识别单元当前不是注册模板，引擎适配器应将 EnrollmentStatus.TemplateStatus 字段设置为 WINBIO_E_INVALID_OPERATION 并返回 S_OK 作为函数的值。

要求

要求 值
最低受支持的客户端 Windows 10 [仅限桌面应用]
最低受支持的服务器 Windows Server 2016 [仅限桌面应用]
目标平台 Windows
标头 winbio_adapter.h (包括 Winbio_adapter.h)