VAPIMWP_PRINT_PRINTTOPRINTER

Prints the document to the specified printer. This is a parameter of the VAPIM_PRINT message.

Syntax

#include <kvvapi.h>
SendMessage(hWndVAPI, VAPIM_PRINT, VAPIMWP_PRINT_PRINTTOPRINTER,
           (LPARAM) (LPCSTR*) lpszPrinterDriver );

Arguments

Argument

Description

hWndVAPI

The handle of the VAPI window.

lpszPrinterDriver

A string in the operating system code page that is the name of the printer driver, or NULL for the default printer. This string must be of the form printername, printerdevice, printerport. For example:

\\Calculus\HP LaserJet IIISi,winspool,NE00:.

Returns

SendMessage() returns TRUE if the call succeeds; otherwise it returns FALSE.

Discussion

  • This message prints to the specified printer without calling the common Print dialog box. You can use this message to implement a Print menu item or toolbar button.

  • When printing in an application that is a Windows service, a default printer must be installed for the user account using the application.

  • To make sure that the entire document is opened before the document is printed, open the document with the bWait member in the TPVAPIOpenDocumentInfo structure set to TRUE. Use the VAPIMWP_PRINT_CANPRINT message to determine whether the document has been completely processed and is ready to be printed.

  • The printerdevice in lpszPrinterDriver must be WINSPOOL, because WINSPOOL is the output device used by Microsoft Windows for all printers.