Scanner.ErrorEvent Event (POS for .NET v1.12 SDK Documentation)

2/27/2008

Raised by the Service Object to notify the application that an error has been detected while attempting to read scanned data.

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

Syntax

'Declaration
Public Event ErrorEvent As DeviceErrorEventHandler

public abstract event DeviceErrorEventHandler ErrorEvent

public:
virtual event DeviceErrorEventHandler^ ErrorEvent {
    void add (DeviceErrorEventHandler^ value) abstract;
    void remove (DeviceErrorEventHandler^ value) abstract;
}

/** @event */
public abstract void add_ErrorEvent (DeviceErrorEventHandler value)

/** @event */
public abstract void remove_ErrorEvent (DeviceErrorEventHandler value)

Remarks

The DeviceErrorEventArgs.ErrorLocus property can be one of the following:

Value	Meaning
Input	Error occurred while gathering or processing event-driven input. No input data is available.
InputData	Error occurred while gathering or processing event-driven input and some previously buffered data is available.

The DeviceErrorEventArgs.ErrorResponse property is preset by the Service Object to a default value, based on the DeviceErrorEventArgs.ErrorLocus. The application may change it to one of the following:

Value	Meaning
Clear	Clear the buffered input data. Typically, the application has called the ClearInput method to clear all input buffers and queued events. The error state is then exited. Default when locus is Input.
ContinueInput	Use only when locus is InputData. Acknowledges the error and directs the Service Object to continue processing. The Service Object remains in the error state and delivers additional data events as directed by the DataEventEnabled property. When all input has been delivered and the DataEventEnabled property is again set to true, then another ErrorEvent is delivered with locus Input. Default when locus is InputData.

Note

Input error events are not delivered until the application has set the DataEventEnabled property to true, indicating that it is ready to receive more input.

See Also

Reference

Scanner Class
Scanner Members
Microsoft.PointOfService Namespace
DeviceErrorEventArgs Class
DeviceErrorEventHandler Delegate
Scanner.DataEventEnabled Property