PIBIO_ENGINE_QUERY_EXTENDED_ENROLLMENT_STATUS_FN回呼函式 (winbio_adapter.h)

  • 發行項

當用戶端應用程式查詢 WINBIO_PROPERTY_EXTENDED_ENROLLMENT_STATUS 屬性時，由 Windows 生物特徵辨識架構 呼叫 。

語法

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 值，以指出錯誤。

傳回碼 Description
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)