Share via

PinPadBase.BeginEftTransactionImpl Method (POS for .NET v1.14 SDK Documentation)

  • Article

3/2/2014

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
Protected MustOverride Sub BeginEftTransactionImpl ( _
    pinpadSystem As PinPadSystem, _
    transactionHost As Integer _
)

protected abstract void BeginEftTransactionImpl (
    PinPadSystem pinpadSystem,
    int transactionHost
)

protected:
virtual void BeginEftTransactionImpl (
    PinPadSystem pinpadSystem, 
    int transactionHost
) abstract

protected abstract void BeginEftTransactionImpl (
    PinPadSystem pinpadSystem, 
    int transactionHost
)

protected abstract function BeginEftTransactionImpl (
    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 calls BeginEftTransactionImpl from its BeginEftTransaction method. BeginEftTransactionImpl must be implemented by the service object to place the PIN pad device in EFT Transaction Mode. Before calling the BeginEftTransactionImpl, the PinPadBase class ensures that the following is true:

  • The PIN pad device has been opened, claimed, and enabled;

  • The PIN pad isn’t already performing an EFT transaction; and

  • The value specified for the pinpadSystem parameter exists in the PinPadSystem enumeration.

If these validations succeed, the PinPadBase class calls BeginEftTransactionImpl. If any of the above conditions aren’t met, the PinPadBase class throws an exception.

The service object should check to ensure the transactionHost parameter specifies a transaction host that is supported.

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
PinPad.BeginEftTransaction Method
PinPad.BeginEftTransaction Method
PinPadSystem Enumeration