Share via

PinPad.EnablePinEntry Method

  • Article

2/27/2008

Starts PIN entry at the PIN pad device. When EnablePinEntry is called, the service object sets the PinEntryEnabled property to true.

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

Syntax

'Declaration
Public MustOverride Sub EnablePinEntry

public abstract void EnablePinEntry ()

public:
virtual void EnablePinEntry () abstract

public abstract void EnablePinEntry ()

public abstract function EnablePinEntry ()

Remarks

When the user has completed the PIN entry operation (either by entering their PIN or by hitting Cancel), the service object calls the ExitPinEntry protected method of the PinPadBase class. ExitPinEntry raises a DataEvent event to provide the encrypted PIN to the application (when the DataEventEnabled property is set to true). In addition, ExitPinEntry sets the PinEntryEnabled property to false.

Note that any data the user enters at the PIN pad while the PinEntryEnabled property is set to true will be supplied in encrypted form to the application and will NOT be provided to any associated PosKeyboard Class.

EnablePinEntry 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 EnablePinEntry.

Busy

The PinEntryEnabled property was already set to true, indicating that the PIN pad device is already performing pin entry.

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
PinEntryEnabled
Prompt
PinPad.BeginEftTransaction Method