WINBIO_IDENTITY結構

WINBIO_IDENTITY結構包含與生物特徵辨識範本相關聯的識別值。

語法

typedef struct _WINBIO_IDENTITY {
  WINBIO_IDENTITY_TYPE Type;
  union {
    ULONG  Null;
    ULONG  Wildcard;
    GUID   TemplateGuid;
    struct {
      ULONG Size;
      UCHAR Data[SECURITY_MAX_SID_SIZE];
    } AccountSid;
  } Value;
} WINBIO_IDENTITY;

成員

類型

指定這個結構中包含的識別資訊格式。 這個值可以是下列其中一個值：

值	意義
WINBIO_ID_TYPE_Null	範本沒有相關聯的識別碼。
WINBIO_ID_TYPE_WILDCARD	結構符合所有範本身分識別。
WINBIO_ID_TYPE_GUID	結構包含與範本相關聯的 GUID。
WINBIO_ID_TYPE_SID	結構包含與範本相關聯的帳戶 SID。

值

可包含下列其中一個值的聯集：

Null

如果 Type 成員 WINBIO_ID_TYPE_Null，則包含 1。

萬用字元

如果 Type 成員 WINBIO_ID_TYPE_WILDCARD，則包含 1。

TemplateGuid

包含 128 位 GUID 值，如果 Type 成員 是WINBIO_ID_TYPE_GUID，則會識別範本。

AccountSid

如果 Type 成員 WINBIO_ID_TYPE_SID，則為包含帳戶 SID 的結構。

大小

SID 中的字元數。

Data

包含 SID 之不帶正負號字元的陣列。 陣列目前的大小上限為 68 個字元。

備註

此結構用於下列函式：

• WinBioDeleteTemplate
• WinBioEnrollCommit
• WinBioEnumEnrollments
• WinBioGetCredentialState
• WinBioIdentify
• WinBioRemoveCredential
• WinBioVerify
• WinBioVerifyWithCallback

規格需求

需求	值
最低支援的用戶端	Windows 7 [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 R2 [僅限桌面應用程式]
標頭	Winbio_types.h (包含 Winbio.h)

另請參閱

用戶端應用程式結構