home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / STDPRN.ZIP / STDPRN.H < prev    next >
C/C++ Source or Header  |  1989-09-02  |  4KB  |  70 lines
  1. /****************************************************************************
  2.  * STDPRN.H - Standard printer functions header file                        *
  3.  *                                                                          *
  4.  *  This file contains the function prototypes for the functions in the     *
  5.  *  standard printer function DLL (stdprn.dll).                             *
  6.  *                                                                          *
  7.  *  Note that stdprn.dll was created as a single thread DLL, thus the       *
  8.  *  calling process must ensure that multiple threads are not attempting    *
  9.  *  to call the same function at the same time.                             *
  10.  *                                                                          *
  11.  *  Modifications -                                                         *
  12.  *      19-Jul-1989 : Initial version                                       *
  13.  ****************************************************************************/
  14.  
  15. #pragma comment(lib,"stdprn.lib")
  16.  
  17. extern HDC APIENTRY OpenDefaultPrinterDC( HAB hab,
  18.                                           PSZ pszAppName,
  19.                                           PSZ pszRedirect );
  20.     /* Purpose          This function opens a device context for the
  21.      *                  current default printer. Use the DevCloseDC
  22.      *                  function to close this device context when
  23.      *                  you are finished with it.
  24.      *
  25.      * Parameters       hab contains the anchor block handle.
  26.      *
  27.      *                  pszAppName is a pointer to a null-terminated
  28.      *                  string that contains the application name.
  29.      *
  30.      *                  pszRedirect is a pointer to a null-terminated
  31.      *                  string that contains the name of the file to
  32.      *                  which printer output is to be redirected. This
  33.      *                  parameter is set to NULL if no output redirection
  34.      *                  is to take place.
  35.      *
  36.      * Return Value     This function returns a handle to the opened
  37.      *                  printer device context. The return value is
  38.      *                  DEV_ERROR if the function is unsuccessful.
  39.      */
  40.  
  41. extern LONG APIENTRY StartDocument( HDC hdcPrinter,PSZ pszDocName );
  42.     /* Purpose          This function allows the application to signal
  43.      *                  that a new print job is starting.
  44.      *
  45.      * Parameters       hdcPrinter contains a handle to a previously
  46.      *                  opened printer device context.
  47.      *
  48.      *                  pszDocName points to a null-terminated ASCII
  49.      *                  containing the name of the document.
  50.      *
  51.      * Return Value     This function returns DEV_OK if no error occurred,
  52.      *                  otherwise it returns a value of DEVESC_ERROR or
  53.      *                  or DEVESC_NOTIMPLEMENTED.
  54.      *
  55.      * Notes            Do not use the start/end document functions if
  56.      *                  printer output has been redirected to a file.
  57.      */
  58.  
  59. extern LONG APIENTRY EndDocument( HDC hdcPrinter );
  60.     /* Purpose          This function ends a print job started by the
  61.      *                  StartDocument function.
  62.      *
  63.      * Parameters       hdcPrinter contains a handle to a previously
  64.      *                  opened printer device context.
  65.      *
  66.      * Return Value     This function returns DEV_OK if no error occurred,
  67.      *                  otherwise it returns a value of DEVESC_ERROR or
  68.      *                  or DEVESC_NOTIMPLEMENTED.
  69.      */
  70.