Msr.ErrorReportingType Property (POS for .NET v1.12 SDK Documentation)

2/27/2008

Holds the type of error reporting the application wants to receive. Possible values are defined by the MsrErrorReporting enumeration.

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

Syntax

'Declaration
Public MustOverride Property ErrorReportingType As MsrErrorReporting

public abstract MsrErrorReporting ErrorReportingType { get; set; }

public:
virtual property MsrErrorReporting ErrorReportingType {
    MsrErrorReporting get () abstract;
    void set (MsrErrorReporting value) abstract;
}

/** @property */
public abstract MsrErrorReporting get_ErrorReportingType ()

/** @property */
public abstract void set_ErrorReportingType (MsrErrorReporting value)

public abstract function get ErrorReportingType () : MsrErrorReporting

public abstract function set ErrorReportingType (value : MsrErrorReporting)

Remarks

The service object reports an error by means of an ErrorEvent when a card is swiped and one or more of the tracks specified by the TracksToRead property contains data with errors. When the ErrorEvent event is raised by the service object to the application, two types of error reporting are supported:

• Card level: A general error status is given, with no data returned.

  The service object should use this level when a simple pass/fail of the card data is sufficient.

• Track level: The service object can return an extended status with a separate status for each of the tracks. Also, for those tracks that contain valid data or no data, the track’s properties are updated as with a DataEvent. For those tracks that contain invalid data, the track’s properties are set to empty.

  The service object should use this level when the application may be able to utilize a successfully read track or tracks even though another of the tracks contains errors.

  For example, suppose TracksToRead is set to Tracks123, and a swiped card contains good track 1 and 2 data, but track 3 contains “random noise” that is flagged as an error by the MSR device. With track-level error reporting, the service object sets the track 1 and 2 properties with the valid data, sets the track 3 properties to empty, and returns an error code indicating the status of each track.

ErrorReportingType is typically initialized to MsrErrorReporting.Card. The application should then set ErrorReportingType according to the type of error reporting it wants to receive.

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

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

Msr Class
Msr Members
Microsoft.PointOfService Namespace
MsrErrorReporting
TracksToRead
DataEvent
ErrorEvent