VENDOR_ATTR structure (smclib.h)

The VENDOR_ATTR structure defines the data that is stored in the VendorAttr member of the SMARTCARD_EXTENSION structure. VENDOR_ATTR also holds information that identifies the smart card reader, such as the vendor name, unit number, and serial number.

Syntax

typedef struct _VENDOR_ATTR {
  struct {
    USHORT Length;
    UCHAR  Buffer[MAXIMUM_ATTR_STRING_LENGTH];
  } VendorName;
  struct {
    USHORT Length;
    UCHAR  Buffer[MAXIMUM_ATTR_STRING_LENGTH];
  } IfdType;
  ULONG  UnitNo;
  struct {
    USHORT BuildNumber;
    UCHAR  VersionMinor;
    UCHAR  VersionMajor;
  } IfdVersion;
  struct {
    USHORT Length;
    UCHAR  Buffer[MAXIMUM_ATTR_STRING_LENGTH];
  } IfdSerialNo;
  ULONG  Reserved[25];
} VENDOR_ATTR, *PVENDOR_ATTR;

Members

VendorName

A structure with the following members:

VendorName.Length

Contains the length of the ANSI-coded name of the vendor. This member is required.

VendorName.Buffer[MAXIMUM_ATTR_STRING_LENGTH]

Contains the ANSI-coded name of the vendor. Because a length field is provided, no terminating NULL character is necessary. This member is required.

IfdType

A structure with the following members:

IfdType.Length

Contains the length of the ANSI-coded designation of the reader. This member is required.

IfdType.Buffer[MAXIMUM_ATTR_STRING_LENGTH]

Contains the ANSI-coded reader name. This member is required.

UnitNo

Contains the zero-based number of this unit. Because you can have more than one reader of this kind installed, UnitNo can distinguish the readers. This member is required.

IfdVersion

A structure with the following members:

IfdVersion.BuildNumber

Contains the build number of the reader driver. This member can be used for support purposes and should be maintained only if the reader allows the value to be queried. This member is optional.

IfdVersion.VersionMinor

Contains the minor version number of the reader driver. This member can be used for support purposes and should be maintained only if the reader allows the value to be queried. This member is optional.

IfdVersion.VersionMajor

Contains the major version number of the reader driver. This member can be used for support purposes and should be maintained only if the reader allows the value to be queried. This member is optional.

IfdSerialNo

A structure with the following members:

IfdSerialNo.Length

Contains the length of the serial number, in bytes, of the connected reader.

IfdSerialNo.Buffer[MAXIMUM_ATTR_STRING_LENGTH]

A pointer to the serial number of the connected reader. This field should only be maintained if the reader allows the serial number to be queried. This member is optional.

Reserved[25]

Reserved for system use.

Requirements