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	模板没有关联的 ID。
WINBIO_ID_TYPE_WILDCARD	结构匹配所有模板标识。
WINBIO_ID_TYPE_GUID	结构包含与模板关联的 GUID。
WINBIO_ID_TYPE_SID	结构包含与模板关联的帐户 SID。

值

可包含以下值之一的联合：

Null

如果类型成员WINBIO_ID_TYPE_NULL，则包含 1。

通配符

如果类型成员WINBIO_ID_TYPE_WILDCARD，则包含 1。

TemplateGuid

包含一个 128 位 GUID 值，该值标识模板（如果 Type 成员是 WINBIO_ID_TYPE_GUID）。

AccountSid

如果 类型 成员 WINBIO_ID_TYPE_SID，则包含帐户 SID 的结构。

大小

SID 中的字符数。

数据

包含 SID 的无符号字符数组。 数组的当前最大大小为 68 个字符。

备注

此结构用于以下函数：

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

要求

要求	值
最低受支持的客户端	Windows 7 [仅限桌面应用]
最低受支持的服务器	Windows Server 2008 R2 [仅限桌面应用]
标头	Winbio_types.h (包括 Winbio.h)

另请参阅

客户端应用程序结构