Метод IPrintOemUI::UpgradePrinter (prcomoem.h)

Статья
02/07/2025

Метод IPrintOemUI::UpgradePrinter позволяет подключаемым модулем пользовательского интерфейса обновлять значения параметров устройства, хранящиеся в реестре.

Синтаксис

HRESULT UpgradePrinter(
  DWORD dwLevel,
  PBYTE pDriverUpgradeInfo
);

Параметры

dwLevel

Номер версии, предоставленной вызывающим номером структуры, на которую указывает pDriverUpgradeInfo. Текущее допустимое значение равно 1.

pDriverUpgradeInfo

Указатель на DRIVER_UPGRADE_INFO_1 структуру, предоставляемую вызывающим абонентом.

Возвращаемое значение

Метод должен возвращать одно из следующих значений.

Возвращаемый код	Описание
S_OK	Операция завершилась успешно.
E_FAIL	Сбой операции.
E_NOTIMPL	Метод не реализован.

Замечания

Если вы предоставляете подключаемый модуль пользовательского интерфейса для одного из драйверов принтера Майкрософт, а если подключаемый модуль пользовательского интерфейса хранит значения параметров устройства в реестре, он должен реализовать метод IPrintOemUI::UpgradePrinter для обновления этих значений.

Метод IPrintOemUI::UpgradePrinter пользовательского интерфейса выполняет те же типы операций, что и функция DrvUpgradePrinter, экспортируемая библиотеками DLL интерфейса принтера в пользовательском режиме. Когда вызывается функция драйвера DrvUpgradePrinter, она обновляет собственные значения реестра, а затем вызывает метод IPrintOemUI::UpgradePrinter.

Если методы IPrintOemUI::UpgradePrinter экспортируются несколькими подключаемыми модулями пользовательского интерфейса, методы вызываются в том порядке, в который указываются подключаемые модули для установки.

Дополнительные сведения о создании и установке подключаемых модулей пользовательского интерфейса см. в настройке драйверов принтера Майкрософт.

Требования

Требование	Ценность
целевая платформа	Настольный
заголовка	prcomoem.h (include Prcomoem.h)

Поделиться через