BumpBar.ErrorEvent Event

Notifies the application that a Bump Bar error has been detected and a suitable response by the application is necessary to process the error condition.

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

Usage

'Usage
WithEvents bumpBar1 As BumpBar
Function bumpBar1_ErrorEvent(sender As Object, _
    e As DeviceErrorEventArgs) As Void
    Handles bumpBar1.ErrorEvent
End Function

Syntax

'Declaration
Public MustOverride Event ErrorEvent As DeviceErrorEventHandler

public abstract event DeviceErrorEventHandler ErrorEvent;

public: abstract event DeviceErrorEventHandler^ ErrorEvent;

public abstract  void add_ErrorEvent(DeviceErrorEventHandler handler);
public abstract  void remove_ErrorEvent(DeviceErrorEventHandler handler);

In JScript, you can handle the events defined by a class, but you cannot define your own.

Remarks

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

Value	Description
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.
Output	Error occurred while processing asynchronous output.

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

Value	Description
Clear	Clear all buffered output data (including all asynchronous output) or buffered input data. The error state is 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 will deliver additional DataEvent 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.
Retry	Use only when locus is Output. Retry the asynchronous output. The error state is exited. Default when locus is Output.

ErrorEvent is queued when an error is detected while gathering data from or processing asynchronous output for the bump bar.

Input error events are not delivered until the DataEventEnabled property is TRUE, so that proper application sequencing occurs.

The EventUnits and EventString properties are updated before ErrorEvent is delivered.

Platforms

Development Platforms

Windows XP Home Edition, Windows XP Professional, Windows Server 2003, Windows Longhorn, and Windows 2000

Target Platforms

See Also

Reference

BumpBar Class
BumpBar Members
Microsoft.PointOfService Namespace
DeviceErrorEventArgs
DataEventEnabled
EventUnits
EventString