CARD_SIGNING_INFO Structure

This topic is not current. For the most current information about the Smart Card API, see Smart Card Minidriver Specification.

The CARD_SIGNING_INFO structure specifies data to be signed by the CardSignData function.

Syntax

typedef struct _CARD_SIGNING_INFO {
  DWORD  dwVersion;
  BYTE   bContainerIndex;
  DWORD  dwKeySpec;
  DWORD  dwSigningFlags;
  ALG_ID aiHashAlg;
  PBYTE  pbData;
  DWORD  cbData;
  PBYTE  pbSignedData;
  DWORD  cbSignedData;
  LPVOID pPaddingInfo;
  DWORD  dwPaddingType;
} CARD_SIGNING_INFO, *PCARD_SIGNING_INFO;

Members

dwVersion

The version number of the structure. You must set this member to 1.

bContainerIndex

The key container index number. The container holds the keys used to sign the data.

dwKeySpec

The purpose of the keys in the key container. This member can be one of the following values.

ValueMeaning
AT_KEYEXCHANGE
1

The keys in the container are used to encrypt and decrypt session keys.

AT_SIGNATURE
2

The keys in the container are used to create and verify digital signatures.

 

dwSigningFlags

Specifies certain behavior of this structure. The following flags are defined.

ValueMeaning
CARD_BUFFER_SIZE_ONLY
0x20000000

The card module returns only the size of the signed data in the cbSignedData member, and is not required to return the signed data in the pbSignedData member.

CARD_PADDING_INFO_PRESENT
0x40000000 (0x40000000)

The pPaddingInfo member points to a structure specified by the dwPaddingType member. Otherwise, the pPaddingInfo member is ignored.

 

aiHashAlg

A value of the ALG_ID enumeration that specifies the algorithm used to sign the data.

pbData

A pointer to an array that contains the data to be signed.

cbData

The size, in bytes, of the pbData array.

pbSignedData

A pointer to an array that, on output, contains the signed data.

cbSignedData

The size, in bytes, of the pbSignedData buffer.

pPaddingInfo

A pointer to a structure that specifies padding scheme options. The value of the dwPaddingType member determines which padding structure is used.

Windows Server 2003, Windows 2000 Server with SP4 and later, Windows XP, and Windows 2000 Professional with SP4 and later:  This member is not supported.
dwPaddingType

The type of padding structure that the pPaddingInfo member points to. The following values are defined.

Windows Server 2003, Windows 2000 Server with SP4 and later, Windows XP, and Windows 2000 Professional with SP4 and later:  This member is not supported.
ValueMeaning
CARD_PADDING_NONE
1 (0x1)

No card padding structure is used.

CARD_PADDING_PKCS1
2 (0x2)

The pPaddingInfo member points to a BCRYPT_PKCS1_PADDING_INFO structure. PKCS1 version 1.5 padding is used, and the object identifier (OID) of the hash algorithm is embedded in the signature.

CARD_PADDING_PSS
4 (0x4)

The pPaddingInfo member points to a BCRYPT_PSS_PADDING_INFO structure. PKCS1 version 2.0 PSS padding is used. This value is supported only by card modules called by the smart card key storage provider (KSP).

 

Requirements

Minimum supported client

Windows XP

Minimum supported server

Windows Server 2003

Header

Cardmod.h

See Also

Microsoft Base Smart Card Cryptographic Service Provider
CardSignData

 

 

Send comments about this topic to Microsoft

Build date: 4/19/2011

Show: