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 (包括 Prcomoem.h)