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.

Example Code



 * 1) define INCL_SPL
 * 2) define INCL_SPLDOSPRINT
 * 3) include 

HFILE   hDevice;  /*  The device handle returned by PrtOpen. */ ULONG   rc;       /*  Return codes. */

rc = PrtResetAbort(hDevice); 