InputObj
InputObj
Summary
| Method | |
|---|---|
| Clear | |
| SetEncryption | |
| Property | |
|---|---|
| Data | |
| EncryptionType | |
| MaxLength | |
| MinLength | |
| Text | |
The InputObj object is used to handle the input data when the wizard control is configured for PIN code entry. The InputObj handles all the interaction between the user and the pad, greatly simplifying the coding effort needed. It is used to set the PIN configuration, including its minimum and maximum lengths and the type of encryption required.
Methods
Clear
Resets the input object ready to restart PIN capture.
| void Clear() | |
|---|---|
| Parameters | |
| None | |
| Return Value | |
| None |
SetEncryption
Sets the encryption of the InputObject data. Once set, encryption cannot be changed except by first calling the Clear method. Currently, the only encryption algorithm supported is TripleDES. For this algorithm, "Key" must be a 24-byte (192-bit) binary value either in a byte array (a SafeArray of type VT_UI1) or a base64 encoded string. In addition, the following information will be required for decryption:
- Cipher mode: CBC (cipher block chaining)
- Initialisation Vector: 8 bytes, all zero
- Padding mode: PKCS 5
| void SetEncryption(Type, Key) | |
|---|---|
| Parameters | |
| Type | EncryptAlg enum value specifying type of encryption to be used. |
| Key | VARIANT. The encryption key to be used. |
| Return Value | |
| None | |
Properties
| Property | Type | Description |
|---|---|---|
| Data | VARIANT | Gets the data entered by the user in the form of a byte array. |
| EncryptionType | LONG | Returns the type of encryption being used. Note: The encryption type is set using the SetEncryption method. |
| MaxLength | short | The maximum number of digits in the PIN. |
| MinLength | short | The minimum number of digits in the PIN. |
| Text | BSTR | Gets the data entered by the user. If no encryption is used the string will contain the digits as entered, otherwise the result will be a Base64 encoded encrypted string. |