IContinueCallback::FContinuePrinting

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This method answers whether a given lengthy printing operation should continue.

Syntax

HRESULT FContinuePrinting(
  LONG cPagesPrinted, 
  LONG nCurrentPage, 
  LPOLESTR pszPrintStatus 
);

Parameters

  • cPagesPrinted
    [in] Total number of pages that have been printed at the time the object receives a call to IContinueCallback::FContinuePrinting.
  • nCurrentPage
    [in] Page number of the page being printed at the time the object receives a call to IContinueCallback::FContinuePrinting.
  • pszPrintStatus
    [in] Pointer to message about the current status of the print job. The object being printed may or may not display this message to the user. May be NULL.

Return Value

This method supports the standard return value E_UNEXPECTED.

If the printing operation should continue, the method returns S_OK.

If the print job should be cancelled as soon as possible, the method returns S_FALSE.

Remarks

Implementations of IPrint::Print call this method at periodic intervals during the printing process.

The IPrint implementation should call back at least after printing each page, so that its client can, if necessary, display useful visual feedback to the user.

IPrint::Print can call back multiple times with the same cPagesPrinted and nCurrentPage values, which is sometimes useful when a page being printed is complex and it is appropriate to give a user an opportunity to cancel in mid-page.

To determine whether the platform supports this interface, see Determining Supported COM APIs.

Requirements

Header docobj.h
Library Developer Implemented
Windows Embedded CE Windows CE 3.0 and later
Windows Mobile Windows Mobile Version 5.0 and later