Important Notice

The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.

                                                     ◄Up► ◄Next► ◄Previous►
────────────────────────────────────────────────────────────────────────────
 
#define STARTDOC 10 
short Control(lpDevice, STARTDOC, lpDocName, NULL)
LPPDEVICE lpDevice;
LPSTR lpDocName;
 
The STARTDOC escape informs the device driver that a new print job is
starting and that all subsequent NEWFRAME escapes should be spooled under
the same job, until an ENDDOC escape occurs.
 
This ensures that documents longer than one page will not be interspersed
with other jobs.
 
Parameter  Description
────────────────────────────────────────────────────────────────────────────
 
lpDevice   Points to a PDEVICE structure specifying the destination device.
 
lpDocName  Points to a null-terminated string specifying the name of the
           document. The document name is displayed in  Print Manager.
 
Return Value
 
The return value is positive if successful. Otherwise, it is -1 if an error
occurs, such as insufficient memory or an invalid port specification.
 
See Also
 
ABORTDOC, ENDDOC, NEWFRAME, PDEVICE
 
 
                                      ♦