CardPinControl.BuildTerminalModifyCommandAPDU Method

Public Function BuildTerminalModifyCommandAPDU( _ 
   ByVal nSlot As Integer, _ 
   ByVal vsLabels As String(), _ 
   ByVal nTimeout As Integer _ 
) As CardCommandAPDU

This language is not supported or no code example is available.

public CardCommandAPDU BuildTerminalModifyCommandAPDU( 
   int nSlot, 
   string[] vsLabels, 
   int nTimeout 
)

This language is not supported or no code example is available.

public:  
CardCommandAPDU^ BuildTerminalModifyCommandAPDU( 
   int nSlot, 
   array< String^ >^ vsLabels, 
   int nTimeout 
) 

This language is not supported or no code example is available.

public function BuildTerminalModifyCommandAPDU( 
    nSlot : int, 
    vsLabels : String[], 
    nTimeout : int 
) : CardCommandAPDU;

This language is not supported or no code example is available.

Parameters

nSlot

Type: int

The card terminal slot number of the slot where the card to receive the modify command is inserted.

vsLabels

Type: string[]

Optional array of text labels that replace the default labels. If null, then no special labels will be specified in the created terminal command APDU. If it is provided, then it must contain 6 strings that replace the following labels in the order given.

• Please enter PIN
• Action successful
• PIN wrong or blocked
• Please enter new PIN
• Repeat input
• PIN not identical. Abort

According to the CT-BCS specification only ASCII characters are allowed. The max length of the display string is 16 characters. If this is null, then no label will be set.

nTimeout

Type: int

Maximum time to wait for the user to enter the first digit (or letter) of the PIN. This time is given in seconds. If the user does not begin to enter his PIN within this timeout, then the PIN entry is automatically cancelled. Usually there is also an implicit timeout between every digit of the PIN, but this is implementation or device specific and cannot be controlled by this method.

If this is zero, then some card terminal specific default timeout will be applied. Very large timeouts are shortened to the maximum of 255 seconds. Negative values are not allowed.

Return Value

If successful a new instance of the CardCommandAPDU class is returned that contains a command APDU according to CT-BCS that can be sent to the card terminal in order to perform a secure PIN entry.

.NET Framework

.NET Core

.NET Standard