DrvUpgradePrinter

BOOL DrvUpgradePrinter(

    DWORD  Level,
   LPBYTE  pDriverUpgradeInfo
  );

DrvUpgradePrinter upgrades a printer’s registry device settings.

Parameters

Level

Specifies the version number of the structure to which pDriverUpgradeInfo points. Currently this value is always 1.

pDriverUpgradeInfo

Pointer to a DRIVER_UPGRADE_INFO_1 structure containing the information required by the driver to perform the upgrade.

Return Value

If DrvUpgradePrinter is successful, the return value is TRUE. Otherwise, DrvUpgradePrinter sets a last-error code and returns FALSE.

Comments

The spooler calls DrvUpgradePrinter for every printer when a new printer driver is copied onto the system. This occurs when a system is upgraded from one operating system release to the next, or when a user updates a printer driver by calling the Win32 AddPrinterDriver function. DrvUpgradePrinter should update the registry with the new device settings for the specified printer.