SetForm

The SetForm function sets the form information for the specified printer.

BOOL SetForm(
  HANDLE hPrinter,  // handle to printer object
  LPTSTR pFormName, // address of form name
  DWORD Level,      // structure level
  LPBYTE pForm      // address of structure array
);
 

Parameters

hPrinter
Handle to the printer for which the form information is set.
pFormName
Pointer to a null-terminated string that specifies the form name for which the form information is set.
Level
Specifies the version 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 hPrinter is obtained by calling the OpenPrinter function.

QuickInfo

  Windows NT: Requires version 3.1 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, GetForm, OpenPrinter, FORM_INFO_1