IPrintOemUI::UpgradePrinter method allows a user interface plug-in to upgrade device option values that are stored in the registry.
HRESULT UpgradePrinter( DWORD dwLevel, PBYTE pDriverUpgradeInfo );
Caller-supplied version number of the structure pointed to by pDriverUpgradeInfo. Current valid value is 1.
Caller-supplied pointer to a DRIVER_UPGRADE_INFO_1 structure.
The method must return one of the following values.
||The operation succeeded.|
||The operation failed.|
||The method is not implemented.|
If you provide a user interface plug-in for one of Microsoft's printer drivers, and if the user interface plug-in stores device option values in the registry, it should implement the
IPrintOemUI::UpgradePrinter method to update those values.
A user interface plug-in's
IPrintOemUI::UpgradePrinter method performs the same types of operations as the DrvUpgradePrinter function that is exported by user-mode printer interface DLLs. When the driver's DrvUpgradePrinter function is called, it updates its own registry values and then calls the
IPrintOemUI::UpgradePrinter methods are exported by multiple user interface plug-ins, the methods are called in the order that the plug-ins are specified for installation.
For more information about creating and installing user interface plug-ins, see Customizing Microsoft's Printer Drivers.
|Header||prcomoem.h (include Prcomoem.h)|