Collection of attributes and methods that control the PIN handling and its transformation into a command APDU sent to the smart card.

Namespace: CardWerk.SmartCard
Assembly: CardWerk.SmartCard (in CardWerk.SmartCard.dll)

Public NotInheritable Class CardPinControl
This language is not supported or no code example is available.
public sealed class CardPinControl
This language is not supported or no code example is available.
public ref class CardPinControl sealed 
This language is not supported or no code example is available.
public final class CardPinControl
This language is not supported or no code example is available.
Name Description
Public constructor CardPinControl(CardCommandAPDU, PinEncodingIdentifier, int) Construct a CardPinControl instance from the minimal information required in order to perform a PIN entry and verification.
Public constructor CardPinControl(CardCommandAPDU, PinEncodingIdentifier, int, int) Construct a CardPinControl instance from the minimal information required in order to perform entry of two PINs and perform a PIN modification.
Top
Name Description
Public property Encoding The PIN encoding that is used when inserting the PIN into the command APDU template.
Public property IsAlphanumeric Indicates whether the PIN entry may be alphanumeric.
Public property MaxLength The maximum acceptable length of the PIN.
Public property MinLength The minimum acceptable length of the PIN.
Public property MustConfirm True if the card holder must confirm his PIN entry by pressing the ENTER or OK button.
Public property Offset Byte offset where the PIN shall be inserted into the command APDU template.
Public property Offset2 Byte offset where the second PIN shall be inserted into the command APDU template.
Public property PinBlockLength New in version 4.0: The byte length of a complete PIN block including any padding.
Public property Template The command APDU template that will be used to construct the final VERIFY PIN (or similar) command.
Top
Name Description
Public method BuildCardCommandAPDU(string) Builds the VERIFY command APDU to be sent to the card by filling the given PIN into the command APDU template.
Public method BuildModifyCardCommandAPDU(string, string) Builds the MODIFY command APDU to be sent to the card by filling the given PINs into the command APDU template.
Public method BuildTerminalCommandAPDU(int, string, int) Builds a command APDU to be sent to the terminal in order to perform a secure PIN entry by itself.
Public method BuildTerminalModifyCommandAPDU(int, string[], int) Builds a command APDU to be sent to the terminal in order to perform a secure PIN modification by itself.
Public method EncodePin(string) Helper function that encodes the given PIN as required by this CardPinControl.
Public method IsAcceptablePin(string) Checks a PIN whether it is acceptable according to this PIN control.
Top
This class supports handling of one or two PINs. Two PINs are required when modifying a PIN. If two PINs are used, they must have the same general restrictions. With version 4.0 several changes and additions have been made to this class. All changes are marked with a "New in version 4.0" tag.

.NET Framework

Supported in: 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

.NET Core

Supported in: 2.0, 2.1, 2.2, 3.0, 3.1, 5.0, 6.0, 7.0, 8.0

.NET Standard

Supported in: 2.0