Share via

PinPadBase.BeginEftTransaction Method

  • Article

2/27/2008

Informs the PIN Pad’s service object that an EFT Transaction is starting.

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

Syntax

'Declaration
Public Overrides Sub BeginEftTransaction ( _
    pinpadSystem As PinPadSystem, _
    transactionHost As Integer _
)

public override void BeginEftTransaction (
    PinPadSystem pinpadSystem,
    int transactionHost
)

public:
virtual void BeginEftTransaction (
    PinPadSystem pinpadSystem, 
    int transactionHost
) override

public void BeginEftTransaction (
    PinPadSystem pinpadSystem, 
    int transactionHost
)

public override function BeginEftTransaction (
    pinpadSystem : PinPadSystem, 
    transactionHost : int
)

Parameters

  • pinpadSystem
    Name of the desired PIN Pad Management System.
  • transactionHost
    Identifies the EFT Transaction Host to be used for this transaction.

Remarks

The PinPadBase class verifies that the application has opened, claimed, and enabled the device, checks that the device isn’t already in EFT Transaction Mode, checks the validity of the pinpadSystem parameter, and then calls the BeginEftTransactionImpl protected method. If BeginEftTransactionImpl returns successfully, the device will be placed in EFT transaction Mode.

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

Value

Meaning

Illegal

One of the following conditions has occurred:

  • The requested PIN Pad Management System is not supported by the service object; or

  • The requested EFT Transaction Host is an illegal value for the selected PIN Pad Management System.

Busy

The PIN pad device is already performing an EFT transaction.

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

PinPadBase Class
PinPadBase Members
Microsoft.PointOfService.BaseServiceObjects Namespace
BeginEftTransactionImpl
PinPad.BeginEftTransaction Method