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.

◄CDC►                                         ◄Up► ◄Contents► ◄Index► ◄Back►
──Microsoft Foundation Classes──────────────────────────────────────────────
 
  int StartDoc( const char FAR* pDocName );
 
  Windows 3.1 only
 
  int StartDoc( LPDOCINFO lpDocInfo );
 
  Parameter   Description
 
  <pDocName>  Pointer to a null-terminated string that specifies the name
              of the document. The document name is displayed in the Print
              Manager window. The maximum length of this string is 31
              characters plus the terminating null character.
 
  <lpDocInfo> Points to a DOCINFO structure containing the name of the
              document file and the name of the output file.
 
  Remarks
 
  Informs the device driver that a new print job is starting and that all
  subsequent NEWFRAME escape calls should be spooled under the same job
  until an ENDDOC escape call occurs. This ensures that documents longer
  than one page will not be interspersed with other jobs.
 
  For Windows version 3.1, this function replaces the STARTDOC printer
  escape. Using this function ensures that documents containing more than
  one page are not interspersed with other print jobs.
 
  StartDoc should not be used inside metafiles.
 
  Return Value
 
  The value -1 if there is an error such as insufficient memory or an
  invalid port specification occurs. Otherwise, a positive value.
 
  See Also
 
  ◄CDC::Escape►, ◄CDC::EndDoc►
 
 
                                     -♦-