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

生物特徵辨識單位標識碼。

傳回值

無

規格需求

需求	值
最低支援的用戶端	Windows 7 [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 R2 [僅限傳統型應用程式]
目標平台	Windows
標頭	winbio.h