This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

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.

---

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

See also:

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

Printing in the Photon Programmer's Guide