PrtResetAbort

PrtResetAbort resets an aborted print job to allow a print driver to send multiple reset sequences to the printer. After PrtResetAbort is called successfully, the print driver can issue PrtWrite for this device handle.

Syntax

PrtResetAbort(hDevice)

Parameters

hDevice (HFILE) - input

The device handle returned by PrtOpen.

Return Code

rc (ULONG) - returns

Return codes.

• 0 : Success
• 6 (ERROR_INVALID_HANDLE) : Invalid handle given.
• 127 (ERROR_PROC_NOT_FOUND) : Port driver does not export the SplPdResetAbort API.

Remarks

This function was added to OS/2 Warp, Version 3, to allow print drivers to abort jobs more quickly. The print drivers do this by checking for PrtResetAbort during the print driver's abort processing. If the API exists, the print driver calls PrtAbort to cancel all output being sent to the printer. After all output is aborted, the print driver calls PrtResetAbort, which allows the print driver to call PrtWrite to send the reset sequence to the printer.

PrtClose must still be issued to close the device connection.