PinPad.ComputeMac Method

2/27/2008

Tells the service object to compute a MAC value and return it to the application.

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

Syntax

'Declaration
Public MustOverride Function ComputeMac ( _
    inMsg As String _
) As String

public abstract string ComputeMac (
    string inMsg
)

public:
virtual String^ ComputeMac (
    String^ inMsg
) abstract

public abstract String ComputeMac (
    String inMsg
)

public abstract function ComputeMac (
    inMsg : String
) : String

inMsg
Contains the message that the application intends to send to the EFT Transaction Host.

Depending on the selected PIN Pad Management System, the service object may also insert other fields into the returned string.

Note

The ComputeMac method cannot be used when the PinEntryEnabled property is set to true.

ComputeMac returns the MAC value if successful. It 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 ComputeMac.
Busy	The PinEntryEnabled property is set to true. The PIN pad can’t perform a MAC calculation during PIN entry.

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