Construct a CardPinControl instance from the minimal information required in order to perform a PIN entry and verification.

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

Public Sub New( _ 
ByVal aTemplate As CardCommandAPDU, _ 
ByVal nEncoding As PinEncodingIdentifier, _ 
ByVal nOffset As Integer
)
This language is not supported or no code example is available.
public CardPinControl( 
CardCommandAPDU aTemplate
PinEncodingIdentifier nEncoding
int nOffset 
)
This language is not supported or no code example is available.
public:  
CardPinControl( 
CardCommandAPDU^ aTemplate
PinEncodingIdentifier nEncoding
int nOffset 
)
This language is not supported or no code example is available.
public function CardPinControl( 
aTemplate : CardCommandAPDU
nEncoding : PinEncodingIdentifier
nOffset : int 
);
This language is not supported or no code example is available.

Parameters

aTemplate
Type: CardCommandAPDU

Command APDU template that will be used to construct the final VERIFY PIN (or similar) command. This must not be null and must be a valid ISO 7816-4 command APDU with short length fields. If the parameter nOffset points to the end of the given data field, then the PIN will be appended to the command data and the length Lc is implicitly adjusted to accommodate the actual PIN length.

nEncoding
Type: PinEncodingIdentifier

Selects the encoding of the PIN when it is inserted into the command APDU template.

nOffset
Type: int

Byte offset where the encoded PIN shall be inserted into the command APDU template. The offset is computed relative to the beginning of the data field of the command APDU. The offset must fall within the data field of the given command APDU template.

Exception type Condition

ArgumentOutOfRangeException

The offset is negative or outside the available data field.

ArgumentException

The parameter aTemplate is an extended command APDU; or the requested PIN encoding is not known; or the requested PIN encoding is Format2PinBlock and there is not enough room for an eight byte PIN block starting at nOffset.

ArgumentNullException

The parameter aTemplate was null.

Marc, 9/29/2022.

.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