AddForm

The AddForm function adds a form to the list of available forms that can be selected for the specified printer.

BOOL AddForm(
  HANDLE hPrinter,  // handle to printer object
  DWORD Level,      // data-structure level
  LPBYTE pForm      // pointer to form info. data structure
);
 

Parameters

hPrinter
Handle to the printer that supports printing with the specified form.
Level
Specifies the level of the structure to which pForm points. This value must be 1.
pForm
Pointer to a FORM_INFO_1 structure.

Return Values

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero. To get extended error information, call GetLastError.

Remarks

The printer handle identified by the hPrinter parameter is returned by the OpenPrinter function.

An application can determine which forms are available for a printer by calling the EnumForms function.

QuickInfo

  Windows NT: Requires version 3.51 or later.
  Windows: Unsupported.
  Windows CE: Unsupported.
  Header: Declared in winspool.h.
  Import Library: Use winspool.lib.
  Unicode: Implemented as Unicode and ANSI versions on Windows NT.

See Also

Printing and Print Spooler Overview, Printing and Print Spooler Functions, EnumForms, FORM_INFO_1, OpenPrinter