PFN_CSP_PAD_DATA function pointer

The PFN_CSP_PAD_DATA function can be optionally called by the card to perform cryptographic padding when the card cannot do that itself. For best security, padding should occur on the card. However, it is recognized that not all cards support this feature.

Syntax

typedef DWORD ( WINAPI *PFN_CSP_PAD_DATA)(
  _In_  PCARD_SIGNING_INFO pSigningInfo,
  _In_  DWORD              cbMaxWidth,
  _In_  DWORD              pcbPaddedBuffer,
  _Out_ PBYTE              *ppbPaddedBuffer
);

Parameters

  • pSigningInfo [in]
    Contains buffer to pad plus needed algorithm information.

  • cbMaxWidth [in]
    Block size, in bytes, of the padded buffer.

  • pcbPaddedBuffer [in]
    Populated with the count of bytes in padded buffer.

  • ppbPaddedBuffer [out]
    New buffer that contains original data plus padding.

Return value

Zero on success; otherwise, nonzero.

Remarks

The padded buffer must be released ultimately with a call to PFN_CSP_FREE. The currently supported padding methods are PKCS #1 v1.1 with the Base CSP/KSP-supplied call backs and PSS padding with KSP-supplied callbacks.

Requirements

Target platform

Desktop

Header

Cardmod.h (include Cardmod.h)

 

 

Send comments about this topic to Microsoft