Queue.errorHandler Callback Property

Definition

Queue.errorHandler is invoked by when an internal error occurs in the Queue object. If you pass the name of a user-defined function to Queue.errorHandler, the function will be called when this event occurs. In other words, it is called when an error occurs during the processing of a queue operation. The HRESULT and the error text are passed as parameters.

Usage

Read Yes

Write Yes

Compatibility

This callback is compatible with scripts for Scripter .NET Client. Do not use this callback in scripts for Interaction Connect.

Syntax

Queue.errorHandler(errId, ErrText)

Parameters

errId

The HRESULT error number.

ErrText

Textual description of the error.

Value Assigned

Function Pointer

A function pointer is the address in memory where a user-defined function is loaded. Function pointers pass the address of a user -defined function to another function declared within an application. In a script, the function pointer is simply the name of the function. For example, if your code contains a function named "foo", the function pointer would also be named "foo". Function pointers are used when you wish to change the value of a property. When defining your custom function, you may define the following arguments in the function. e.g.: function foo(errID, errText).

Example

scripter.myQueue.errorHandler = foo;
function foo(errID, errText); {
    alert("Error " + errID + ":" + errText);
}