Builds the VERIFY command APDU to be sent to the card by filling the given PIN into the command APDU template.

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

Public Function BuildCardCommandAPDU( _ 
ByVal sPin As String
) As CardCommandAPDU
This language is not supported or no code example is available.
public CardCommandAPDU BuildCardCommandAPDU( 
string sPin 
)
This language is not supported or no code example is available.
public:  
CardCommandAPDU^ BuildCardCommandAPDU( 
String^ sPin 
)
This language is not supported or no code example is available.
public function BuildCardCommandAPDU( 
sPin : String 
) : CardCommandAPDU;
This language is not supported or no code example is available.

Parameters

sPin
Type: string

The PIN to be filled into the command APDU template.

Return Value

Type: CardCommandAPDU

If successful a new instance of the CardCommandAPDU class is returned that contains the command APDU template filled with the encoded PIN. The returned command APDU can then be sent to the card terminal in order to actually perform the PIN verification.

If the given PIN is not acceptable or it cannot be encoded as required, then null will be returned. Use IsAcceptablePin to check a given PIN before attempting to build a card command APDU.

The given PIN will be checked whether it can be encoded and inserted into the command APDU template according to the properties of this class. If successful, then a new command APDU instance that includes the given PIN will be returned. The command APDU template owned by this class will not be changed. Thus this instance can be re-used in order to create multiple command APDUs.

.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