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

Метод 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
 Метод не реализован.

Комментарии

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

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

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

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

Требования

Требование Значение
Целевая платформа Персональный компьютер
Верхняя часть prcomoem.h (включая Prcomoem.h)