Microsoft KB Archive/118873

{|
 * width="100%"|

PRB: EndPage Returns -1 When Banding

 * }

Q118873

3.10 4.00 | 3.50 3.51 WINDOWS | WINDOWS NT kbprint kbprb

-

The information in this article applies to:


 * Microsoft Windows Software Development Kit (SDK) 3.1
 * Microsoft Win32 Application Programming Interface (API)

-

SYMPTOMS
When an application that implements banding calls EndPage, EndPage returns SP_ERROR (-1).

CAUSE
EndPage returns -1 if there has been no corresponding call to StartPage. Windows keeps track of whether StartPage has been called by maintaining an internal flag that is set when StartPage is called and then is cleared when EndPage is called.

This flag is also cleared when the NEXTBAND escape is called and there are no more bands on the page to be printed. At this point, Windows clears the internal flag and tells the device that a page has been finished. Because the internal flag has been cleared, a subsequent call to EndPage returns -1.

RESOLUTION
Though EndPage returns -1 when it is called from printing code that implements banding, it does no harm. An application can safely call StartPage and EndPage when banding and ignore the -1 error returned from EndPage.

NOTE: It is not recommended that a Win32-based application use banding. Windows NT, spools in a journal file and Windows 95 spools in an enhanced metafile, so all GDI calls are supported without banding.

STATUS
This behavior is by design.

Additional query words: 3.10 4.00 NEWFRAME

Keywords : kbOSWinNT350 kbOSWinNT351 _IK kbSDKWin16

Issue type : kbprb

Technology : kbAudDeveloper kbWin3xSearch kbSDKSearch kbWin32sSearch kbWin32API kbWinSDKSearch kbWinSDK310