PWINBIO_LOCATE_SENSOR_CALLBACK回调函数 (winbio.h)
由 Windows 生物识别框架调用,以从异步 WinBioLocateSensorWithCallback 函数返回结果。 客户端应用程序必须实现此函数。
重要建议从 Windows 8 开始,不再使用 PWINBIO_LOCATE_SENSOR_CALLBACK/WinBioLocateSensorWithCallback 组合。 请改为执行以下操作:
- 实现 PWINBIO_ASYNC_COMPLETION_CALLBACK 函数,以在操作完成时接收通知。
- 调用 WinBioAsyncOpenSession 函数。 在 CallbackRoutine 参数中传递回调的地址。 在 NotificationMethod 参数中传递WINBIO_ASYNC_NOTIFY_CALLBACK。 检索异步会话句柄。
- 使用异步会话句柄调用 WinBioLocateSensor。 操作完成后,Windows 生物识别框架将使用结果分配和初始化 WINBIO_ASYNC_RESULT 结构,并使用指向结果结构的指针调用回调。
- 从回调实现调用 WinBioFree ,以在使用完 WINBIO_ASYNC_RESULT 结构后释放它。
语法
PWINBIO_LOCATE_SENSOR_CALLBACK PwinbioLocateSensorCallback;
void PwinbioLocateSensorCallback(
[in, optional] PVOID LocateCallbackContext,
[in] HRESULT OperationStatus,
WINBIO_UNIT_ID UnitId
)
{...}
参数
[in, optional] LocateCallbackContext
指向由应用程序定义并传递给 WinBioLocateSensorWithCallback 函数的 LocateCallbackContext 参数的缓冲区的指针。 该缓冲区不会由框架或生物识别单元修改。 应用程序可以使用数据来帮助它确定要执行的操作或维护有关生物识别捕获的其他信息。
[in] OperationStatus
捕获操作返回的错误代码。
UnitId
生物识别单元 ID 号。
返回值
无
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 7 [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2008 R2 [仅限桌面应用] |
目标平台 | Windows |
标头 | winbio.h |