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:

Requirements

Requirement Value
Minimum supported client
Windows 7 [desktop apps only]
Minimum supported server
Windows Server 2008 R2 [desktop apps only]
Header
Winbio_types.h (include Winbio.h)

See also

Client Application Structures