PpEndJob()

End a print job

Synopsis:

int PpEndJob( PpPrintContext_t *pc );

Arguments:

pc
The pointer to a PpPrintContext_t structure that was returned by PpCreatePC().

Library:

ph

Description:

This function completes the current print job for the provided print context. If the print context is active, it's deactivated as if PpSuspendJob() had been called.


Note: The print context is deactivated, but isn't destroyed, so it can be used for future print jobs with little or no reconfiguration. To release the print context, call PpReleasePC().

When this function returns, the printed output has been generated and sent to the destination specified in the print context.

Returns:

0
Success.
-1
The print context couldn't be made active, probably because the required print driver couldn't be launched. See errno for the specific error.

Examples:

See PpContinueJob().

Classification:

Photon

Safety:
Interrupt handler No
Signal handler No
Thread No

See also:

PpContinueJob(), PpCreatePC(), PpGetPC(), PpPrintContext_t, PpPrintNewPage(), PpReleasePC(), PpPrintWidget(), PpSetPC(), PpStartJob(), PpSuspendJob()

Printing in the Photon Programmer's Guide