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.


Send feedback to MSDN.Look here for MSDN Online resources.