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 function prepares the printer driver to accept data.

Syntax

int StartPage( 
  HDC 
hDC
);

Parameters

hDC

[in] Handle to the device context (DC) for the print job.

Return Value

A value greater than zero indicates success. A value less than or equal to zero indicates failure. To get extended error information, call GetLastError.

Remarks

For Windows CE 1.0 through 2.01, the device context attributes are not retained between a call to EndPageand a call. You must reselect objects and set up the mapping mode again before printing the next page.

For Windows CE 2.10 and later, neither EndPageor StartPageresets the device context attributes. Device context attributes remain constant across subsequent pages. You do not need to re-select objects and set up the mapping mode again before printing the next page; however, doing so produces identical printer output and is compatible with earlier versions of Windows Embedded CE.

Requirements

Header wingdi.h
Library Mgprint.lib
Windows Embedded CE Windows CE 2.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

EndPage
StartDoc