Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
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::Printcall this method at periodic intervals during the printing process.

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

IPrint::Printcan call back multiple times with the same cPagesPrintedand nCurrentPagevalues, 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