共用方式為

WinBioGetEnrolledFactors 函式 (winbio.h)

  • 發行項

取得計算機上指定使用者所擁有的生物特徵辨識註冊相關信息。 生物特徵辨識註冊包括臉部辨識、指紋掃描、鳶尾花掃描等註冊。

語法

HRESULT WinBioGetEnrolledFactors(
  [in]  WINBIO_IDENTITY       *AccountOwner,
  [out] WINBIO_BIOMETRIC_TYPE *EnrolledFactors
);

參數

[in] AccountOwner

您想要取得其生物特徵辨識註冊的使用者 WINBIO_IDENTITY 結構。 例如：

WINBIO_IDENTITY identity = {};
identity.Type = WINBIO_ID_TYPE_SID;

// Move an account SID into identity.Value.AccountSid.Data.
// For example, CopySid(...)

若要查看計算機上每個用戶的註冊，請針對您為 AccountOwner 參數指定的WINBIO_IDENTITY結構指定WINBIO_ID_TYPE_WILDCARD身分識別類型。 例如：

WINBIO_IDENTITY identity = {};
identity.Type = WINBIO_ID_TYPE_WILDCARD;

[out] EnrolledFactors

一組 WINBIO_BIOMETRIC_TYPE 旗標，指出指定使用者在計算機上擁有的生物特徵辨識註冊。 值為 0 表示用戶沒有生物特徵辨識註冊。

這些註冊僅代表系統集區註冊，例如您可以用來驗證用戶進行登入、解除鎖定等的註冊。 此值不包含私人集區註冊。

如果您為用於 AccountOwner 參數的 WINBIO_IDENTITY 結構指定通配符識別類型，這個旗標集代表計算機上具有帳戶之所有使用者的合併註冊集。

傳回值

如果函式成功，它會傳回 S_OK。 如果函式失敗，它會傳回 HRESULT 值，指出錯誤。 可能的值包括 (但不限於) 下表中的這些值。 如需常見錯誤碼的清單，請參閱 一般 HRESULT 值。

傳回碼 Description
E_POINTER
 AccountOwner 和 EnrolledFactors 參數不可為 NULL。
E_INVALIDARG
 指定 AccountOnwer 參數未WINBIO_ID_TYPE_SID或WINBIO_ID_TYPE_WILDCARD之WINBIO_IDENTITY結構的 Type 成員，或WINBIO_IDENTITY結構的 AccountSid 成員無效。

備註

WinBioGetEnrolledFactors 不需要生物特徵辨識會話句柄，也不會啟用生物特徵辨識服務。 因此， WinBioGetEnrolledFactors 會快速執行，而且當您的程式代碼需要快速決定當時間對於您需要執行的作業集而言，如何繼續執行時，會很有用。

WinBioGetEnrolledFactors 提供認證提供者，以適當地量身打造其 UI。 例如，登入畫面會呼叫 WinBioGetEnrolledFactors ，以判斷是否要顯示使用指紋登入的選項。

範例

WINBIO_BIOMETRIC_TYPE enrolledFactors = WINBIO_NO_TYPE_AVAILABLE;

WINBIO_IDENTITY identity = {};
identity.Type = WINBIO_ID_TYPE_SID;

// Move an account SID into identity.Value.AccountSid.Data.
// e.g., CopySid(...)

HRESULT hr = WinBioGetEnrolledFactors(&identity, &enrolledFactors);

規格需求

需求 值
最低支援的用戶端 Windows 10 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2016 [僅限傳統型應用程式]
目標平台 Windows
標頭 winbio.h
程式庫 Winbio.lib
Dll Winbio.dll

另請參閱

WINBIO_BIOMETRIC_TYPE

WINBIO_IDENTITY