Share via

PinPad.UpdateKey Method

  • Article

2/27/2008

Provides a new encryption key to the PIN pad service object for those PIN Pad Management Systems in which new key values are sent to the terminal as a field in standard messages from the EFT Transaction Host.

Namespace: Microsoft.PointOfService
Assembly: Microsoft.PointOfService (in microsoft.pointofservice.dll)

Syntax

'Declaration
Public MustOverride Sub UpdateKey ( _
    keyNumber As Integer, _
    key As String _
)

public abstract void UpdateKey (
    int keyNumber,
    string key
)

public:
virtual void UpdateKey (
    int keyNumber, 
    String^ key
) abstract

public abstract void UpdateKey (
    int keyNumber, 
    String key
)

public abstract function UpdateKey (
    keyNumber : int, 
    key : String
)

Parameters

  • keyNumber
    Contains a key number.
  • key
    Contains a Hex-ASCII value for a new key.

Remarks

UpdateKey may cause a PosControlException to be thrown with the following ErrorCode:

Value

Meaning

Disabled

The application has not called the BeginEftTransaction method prior to calling EndEftTransaction.

Illegal

One of the following conditions occurred:

  • The selected PIN Pad Management System does not support UpdateKey;

  • The keyNumber parameter specifies an unacceptable key number; or

  • The key parameter contains a bad key (not Hex-ASCII or wrong length or bad parity).

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread-safe. Any instance members are not guaranteed to be thread-safe.

See Also

Reference

PinPad Class
PinPad Members
Microsoft.PointOfService Namespace
PinPad.BeginEftTransaction Method
PinPad.EndEftTransaction Method