WINBIO_IDENTITY structure

The WINBIO_IDENTITY structure contains an identifying value associated with a biometric template.

Syntax

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;

Members

Type

Specifies the format of the identity information contained in this structure. This can be one of the following values:

Value	Meaning
WINBIO_ID_TYPE_NULL	The template has no associated ID.
WINBIO_ID_TYPE_WILDCARD	The structure matches all template identities.
WINBIO_ID_TYPE_GUID	The structure contains a GUID associated with the template.
WINBIO_ID_TYPE_SID	The structure contains the account SID associated with the template.

Value

A union that can contain one of the following values:

Null

Contains 1 if the Type member is WINBIO_ID_TYPE_NULL.

Wildcard

Contains 1 if the Type member is WINBIO_ID_TYPE_WILDCARD.

TemplateGuid

Contains a 128-bit GUID value that identifies the template if the Type member is WINBIO_ID_TYPE_GUID.

AccountSid

A structure that contains an account SID if the Type member is WINBIO_ID_TYPE_SID.

Size

The number of characters in the SID.

Data

An array of unsigned characters that contain the SID. The current maximum size of the array is 68 characters.

Remarks

This structure is used in the following functions:

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

Requirements

See also

Client Application Structures