(v13) last_error

This page applies to Harlequin v13.1r0 and later; and to Harlequin Core but not Harlequin MultiRIP

int32 last_error ( DEVICELIST * dev );

This must return the last error produced by any of the other device routines which have been called on this thread. If called at all, it is called immediately following the call to the routine that produced the error (that is, no other device routines will be called in between).

Calls to last_error (), from any device, should be made in the same thread that made the device call that reported an error. That is, you can't recover the device error in a different thread.

It must return one of the following values (defined in swdevice.h ):

                            DeviceNoError
                            DeviceInvalidAccess
                            DeviceIOError
                            DeviceLimitCheck
                            DeviceUndefined
                            DeviceUnregistered
                            DeviceInterrupted
                            DeviceVMError
                            DeviceReOutput
                            DeviceNotReady
                            DeviceCancelPage
                            DeviceReOutputPageBuffer

The circumstances under which each one should be returned are described in the individual routine descriptions. The last four errors should only be returned by the %pagebuffer% device.