通过

IPrintOemUI：：UpgradePrinter 方法（prcomoem.h）

  • 项目

IPrintOemUI::UpgradePrinter 方法允许用户界面插件升级存储在注册表中的设备选项值。

语法

HRESULT UpgradePrinter(
  DWORD dwLevel,
  PBYTE pDriverUpgradeInfo
);

参数

dwLevel

pDriverUpgradeInfo指向的结构的调用方提供的版本号。 当前有效值为 1。

pDriverUpgradeInfo

调用方提供的指向 DRIVER_UPGRADE_INFO_1 结构的指针。

返回值

该方法必须返回以下值之一。

返回代码 描述
S_OK
 作成功。
E_FAIL
 作失败。
E_NOTIMPL
 未实现该方法。

言论

如果为Microsoft打印机驱动程序之一提供用户界面插件，并且用户界面插件将设备选项值存储在注册表中，则应实现 IPrintOemUI::UpgradePrinter 方法来更新这些值。

用户界面插件的 IPrintOemUI::UpgradePrinter 方法执行与用户模式打印机接口 DLL 导出的 DrvUpgradePrinter 函数相同的作类型。 当调用驱动程序的 DrvUpgradePrinter 函数时，它会更新其自己的注册表值，然后调用 IPrintOemUI::UpgradePrinter 方法。

如果 IPrintOemUI::UpgradePrinter 方法由多个用户界面插件导出，则按照为安装指定插件的顺序调用这些方法。

有关创建和安装用户界面插件的详细信息，请参阅 自定义Microsoft的打印机驱动程序。

要求

要求 价值
目标平台 桌面
标头 prcomoem.h （include Prcomoem.h）